.\"
.TH ASPRINTF 3 2004-11-25 "GNU" "Bibliotheksfunktionen"
.SH NAME
-asprintf, vasprintf \- formatierte Ausgabe in zugeteilte Zeichenketten
-.SH UEBERSICHT
+asprintf, vasprintf \- Ausgabe in allokierte Zeichenkette
+.SH "ÜBERSICHT"
.B #define _GNU_SOURCE
.br
.B #include <stdio.h>
.sp
.BI "int vasprintf(char **" strp ", const char *" fmt ", va_list " ap );
.SH BESCHREIBUNG
-Die Funktionen \fBasprintf\fR und \fBvasprintf\fR sind analog zu
-\fBsprintf\fR und \fBvsprintf\fR, ausgenommen das sie eine
-Zeichenkette zuteilen die lang genug ist, die Ausgabe zu enthalten
-inklusive der terminierenden NUL. Der ersten Parameter wird benutzt
-auf den zugewiesenen Speicher zu zeigen. Der Speicher kann mit
-\fBfree\fR(3) wieder freigegeben werden.
-.SH RUECKGABEWERT
-Wenn erfolgreich, geben diese Funktionen die Anzahl von Bytes zurueck,
-wie bei \fBsprintf\fR(3). Wenn die Speicherzuteilung nicht moeglich,
-oder andere Fehler auftreten, geben diese Funktionen -1 zurueck und
-der Inhalt von \fIstrp\fR ist undefiniert.
-
-.SH ANMERKUNG
+Die Funktionen
+.B asprintf
+und
+.B vasprintf
+sind analog zu
+.B sprintf
+und
+.B vsprintf
+mit der Ausnahme, daß sie Speicherplatz für die Zeichenkette
+allokieren, der ausreichend groß ist, um die Ausgabe inklusive des
+abschließenden NUL-Zeichens aufzunehmen. Ein Zeiger darauf wird über
+den ersten Parameter zurückgegeben. Dieser Zeiger sollte an
+.BR free (3)
+übergeben werden, um den belegten Speicherbereich wieder freizugeben,
+wenn er nicht mehr benötigt wird.
+.SH "RÜCKGABEWERT"
+Wenn erfolgreich, geben diese Funktionen die Anzahl von ausgegebenen
+Bytes zurück, wie bei
+.BR sprintf (3).
+Wenn die Speicherzuteilung nicht möglich war,
+oder andere Fehler auftreten, geben diese Funktionen -1 zurück und
+der Inhalt von
+.I strp
+ist undefiniert.
+.SH ANMERKUNGEN
Diese Funktionen sind GNU Erweiterungen, und nicht in C oder POSIX
-definiert. Sie sind ebenso verfuegbar unter *BSD. Die FreeBSD
-Implementation setzt \fIstrp\fR bei Fehler auf NULL.
-.SH SIEHE AUCH
-
+definiert. Sie sind ebenso verfügbar unter *BSD. Die FreeBSD
+Implementation setzt
+.I strp
+bei Fehler auf NULL.
+.SH "SIEHE AUCH"
.BR free (3),
.BR malloc (3),
-.BR printf (3)
+.BR printf (3).