asprintf(3)

BEZEICHNUNG
asprintf, vasprintf - Ausgabe in reservierte Zeichenkette

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#define _GNU_SOURCE         /* siehe feature_test_macros(7) */
#include <stdio.h>

int asprintf(char **restrict zeichnkz, const char *restrict fmt, …);
int vasprintf(char **restrict zeichnkz, const char *restrict fmt,
              va_list ap);

BESCHREIBUNG
Die Funktionen asprintf() und vasprintf() sind analog zu sprintf(3) und vsprintf(3). Der Unterschied besteht darin, dass sie ausreichend großen Speicherplatz für die Zeichenkette reservieren, um die Ausgabe inklusive des abschließenden Nullbytes (»\0«) aufzunehmen. Ein Zeiger auf den Speicher wird über den ersten Parameter zurückgegeben. Dieser Zeiger sollte an free(3) übergeben werden, um den reservierten Speicherbereich wieder freizugeben, wenn er nicht mehr benötigt wird.

RÜCKGABEWERT
Bei Erfolg geben diese Funktionen, wie auch sprintf(3), die Anzahl ausgegebener Bytes zurück. Im Fehlerfall wird -1 zurückgegeben, errno gesetzt, um den Fehler anzuzeigen und der Inhalt von zeichnkz ist nicht definiert.

FEHLER
Siehe sprintf(3) und malloc(3).

ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
Schnittstelle | Attribut | Wert
asprintf(), vasprintf() | Multithread-Fähigkeit | MT-Sicher locale

VERSIONEN
Bei Fehlern setzt die FreeBSD-Implementierung zeichnkz auf NULL.

STANDARDS
GNU, BSD.

SIEHE AUCH
free(3), malloc(3), printf(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von David Thamm <dthamm@bfs.de>, Martin Schulze <joey@infodrom.org>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer (debian-l10n-german@lists.debian.org).