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 strp, const char *restrict fmt, …);
       int vasprintf(char **restrict strp, 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.  Wenn  Fehler auftreten (z.B. eine gescheiterte Speicherreservierung), geben diese
       Funktionen -1 zurück. Dann ist der Inhalt von strp nicht definiert.

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-Safe locale │
       └────────────────────────────────────────────────┴───────────────────────┴────────────────┘

STANDARDS

       Diese Funktionen sind GNU-Erweiterungen. Sie sind nicht in C  oder  POSIX  definiert.  Sie
       sind  auch  unter  *BSD  verfügbar. Die FreeBSD-Implementierung setzt strp bei Fehlern auf
       NULL.

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> und
       Mario Blättermann <mario.blaettermann@gmail.com> 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⟩.