BEZEICHNUNG

       asprintf, vasprintf - Ausgabe in reservierte Zeichenkette

Ü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 NULL-Bytes ('\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 │
       └────────────────────────────────────────────────┴───────────────────────┴────────────────┘

KONFORM ZU

       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)

KOLOPHON

       Diese Seite  ist  Teil  der  Veröffentlichung  5.13  des  Projekts  Linux-man-pages.  Eine
       Beschreibung  des  Projekts,  Informationen,  wie  Fehler gemeldet werden können sowie die
       aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser  Handbuchseite  wurde  von  David  Thamm  <dthamm@bfs.de>,
       Martin  Schulze  <joey@infodrom.org> und Martin Eberhard Schauer <Martin.E.Schauer@gmx.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⟩.