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 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
       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. Im Fehlerfall wird -1 zuruckgegeben, 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) 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 zeichnkz 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>, Mario Blattermann
       <mario.blaettermann@gmail.com> und Helge Kreutzmann
       <debian@helgefjell.de> 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.18            8. Februar 2026                    asprintf(3)