oracular (3) vasprintf.3.gz

Provided by: manpages-de-dev_4.23.1-1_all bug

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.

       ┌─────────────────────────────────────────────────────────────┬───────────────────────┬──────────────────┐
       │SchnittstelleAttributWert             │
       ├─────────────────────────────────────────────────────────────┼───────────────────────┼──────────────────┤
       │asprintf(), vasprintf()                                      │ Multithread-Fähigkeit │ MT-Sicher locale │
       └─────────────────────────────────────────────────────────────┴───────────────────────┴──────────────────┘

VERSIONEN

       Bei Fehlern setzt die FreeBSD-Implementierung strp 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>   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⟩.