.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Text fragments inspired by Martin Schulze <joey@infodrom.org>.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH asprintf 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
asprintf, vasprintf \- Ausgabe in reservierte Zeichenkette
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#define _GNU_SOURCE\fP         /* siehe feature_test_macros(7) */
\fB#include <stdio.h>\fP
.PP
\fBint asprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB, …);\fP
\fBint vasprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB,\fP
\fB              va_list \fP\fIap\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Die Funktionen \fBasprintf\fP() und \fBvasprintf\fP() sind analog zu \fBsprintf\fP(3)
und \fBvsprintf\fP(3). Der Unterschied besteht darin, dass sie ausreichend
großen Speicherplatz für die Zeichenkette reservieren, um die Ausgabe
inklusive des abschließenden Nullbytes (»\e0«) aufzunehmen. Ein Zeiger auf
den Speicher wird über den ersten Parameter zurückgegeben. Dieser Zeiger
sollte an \fBfree\fP(3) übergeben werden, um den reservierten Speicherbereich
wieder freizugeben, wenn er nicht mehr benötigt wird.
.SH RÜCKGABEWERT
Bei Erfolg geben diese Funktionen, wie auch \fBsprintf\fP(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 \fIstrp\fP nicht definiert.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBasprintf\fP(),
\fBvasprintf\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher locale
.TE
.sp 1
.SH VERSIONEN
Bei Fehlern setzt die FreeBSD\-Implementierung \fIstrp\fP auf NULL.
.SH STANDARDS
GNU, BSD.
.SH "SIEHE AUCH"
\fBfree\fP(3), \fBmalloc\fP(3), \fBprintf\fP(3)
.PP
.SH Ü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.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .