asprintf(3)                Library Functions Manual                asprintf(3)

BEZEICHNUNG
       asprintf, vasprintf - Ausgabe in reservierte Zeichenkette

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

UBERSICHT
       #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
       grossen Speicherplatz fur die Zeichenkette reservieren, um die Ausgabe
       inklusive des abschliessenden Nullbytes (>>\0<<) aufzunehmen. Ein
       Zeiger auf den Speicher wird uber den ersten Parameter zuruckgegeben.
       Dieser Zeiger sollte an free(3) ubergeben werden, um den reservierten
       Speicherbereich wieder freizugeben, wenn er nicht mehr benotigt wird.

RUCKGABEWERT
       Bei Erfolg geben diese Funktionen, wie auch sprintf(3), die Anzahl
       ausgegebener Bytes zuruck. Wenn Fehler auftreten (z.B. eine
       gescheiterte Speicherreservierung), geben diese Funktionen -1 zuruck.
       Dann ist der Inhalt von strp nicht definiert.

ATTRIBUTE
       Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt
       verwandten Ausdrucke.

       +-------------------------+-------------------------+------------------+
       |Schnittstelle            | Attribut                | Wert             |
       +-------------------------+-------------------------+------------------+
       |asprintf(), vasprintf()  | Multithread-Fahigkeit   | MT-Sicher locale |
       +-------------------------+-------------------------+------------------+
VERSIONEN
       Bei Fehlern setzt die FreeBSD-Implementierung strp auf NULL.

STANDARDS
       GNU, BSD.

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

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von David Thamm
       <dthamm@bfs.de>, Martin Schulze <joey@infodrom.org>, Martin Eberhard
       Schauer <Martin.E.Schauer@gmx.de> und Mario Blattermann
       <mario.blaettermann@gmail.com> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

       Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
       schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer
       <debian-l10n-german@lists.debian.org>.

Linux man-pages 6.06           31. Oktober 2023                    asprintf(3)