Ubuntu Manpage: printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf

BEZEICHNUNG

       printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf - formatierte Ausgabe

ÜBERSICHT

       #include <stdio.h>

       int printf(const char *format, ...);
       int fprintf(FILE *stream, const char *format, ...);
       int sprintf(char *str, const char *format, ...);
       int snprintf(char *str, size_t size, const char *format, ...);

       #include <stdarg.h>

       int vprintf(const char *format, va_list ap);
       int vfprintf(FILE *stream, const char *format, va_list ap);
       int vsprintf(char *str, const char *format, va_list ap);
       int vsnprintf(char *str, size_t size, const char *format, va_list ap);

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       snprintf(), vsnprintf():
           _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99

BESCHREIBUNG

Die Funktionenfamilie printf() erzeugt Ausgaben in einem im Folgenden beschriebenen Format. Die
Funktionen printf() und vprintf() schreiben ihre Ausgabe in den Standardausgabekanal stdout; fprintf()
und vfprintf() schreiben in den angegebenen Ausgabekanal stream; sprintf(), snprintf(), vsprintf() und
vsnprintf() schreiben in die Zeichenkette str.

Die Funktionen snprintf() und vsnprintf() schreiben höchstens size Bytes (einschließlich des
abschließenden Null-Bytes ('\0')) nach str.

Die Funktionen vprintf(), vfprintf(), vsprintf(), vsnprintf() sind äquivalent zu den Funktionen printf(),
fprintf(), sprintf() bzw. snprintf(), nur dass sie mit einer va_list statt einer variablen Zahl von
Argumenten aufgerufen werden. Diese Funktionen rufen das Makro va_end nicht auf. Daher ist der Wert von
ap nach dem Aufruf nicht definiert. Siehe stdarg(3).

Diese acht Funktionen schreiben die Ausgabe unter Kontrolle einer Format-Zeichenkette, die angibt, wie
die folgenden Argumente (oder Argumente, auf die mittels der Möglichkeit der variablen Zahl von
Argumenten von stdarg(3) zugegriffen wird) für die Ausgabe konvertiert werden.

C99 und POSIX.1-2001 legen fest, dass die Ergebnisse nicht definiert sind, wenn ein Aufruf von sprintf(),
snprintf(), vsprintf() oder vsnprintf() zu einem Kopieren zwischen überlappenden Objekten führen würde
(z.B., wenn der Ausgabepuffer und eines der übergebenen Eingabe-Argumente sich auf den gleichen Puffer
beziehen). Siehe ANMERKUNGEN.

Rückgabewert
Nach erfolgreicher Ausführung geben diese Funktionen die Anzahl der ausgegebenen Zeichen zurück (ohne das
für den Abschluß der Zeichenkettenausgabe verwendete Null-Byte).

Die Funktionen snprintf() und vsnprintf() schreiben nicht mehr als size Byte (einschließlich dem
abschließenden Null-Byte '\0'). Falls die Ausgabe wegen dieser Begrenzung gekürzt wurde, ist der
Rückgabewert die Anzahl der Zeichen (ohne abschließendes Null-Byte), die bei ausreichendem Speicherplatz
in die Ausgabe geschrieben worden wären. Damit bedeutet ein Rückgabewert von size oder mehr, das die
Ausgabe gekürzt wurde. (Siehe auch im Folgenden unter ANMERKUNGEN.)

Wenn bei der Ausgabe ein Fehler auftritt, wird ein negativer Wert zurückgegeben.

Format des Formatstrings
Der Formatstring ist eine Zeichenkette, die, so vorhanden, in ihrem initialen Shift-Zustand beginnt und
endet. Der Formatstring setzt sich zusammen aus Null oder mehr Anweisungen: normale Zeichen (nicht %)
werden unverändert in den Ausgabekanal kopiert; Umwandlungsanweisungen fordern jeweils null oder mehr
Argumente. Jede Umwandlungsanweisung wird durch das Zeichen % eingeleitet und endet mit einem
Umwandlungssymbol. Dazwischen können (in dieser Reihenfolge) null oder mehr Flags (Schalter), eine
optionale minimale Feldbreite, eine optionale Genauigkeit und ein optionaler Längenmodifikator vorkommen.

Die Argumente müssen (nach Typumwandlung) genau zu den Umwandlungssymbolen passen. Standardmäßig werden
die Argumente in der angegebenen Reihenfolge benutzt, wobei jeder '*' und jedes Umwandlungssymbol das
nächste Argument abfragt (und es ist ein Fehler, wenn nicht ausreichend Argumente angegeben sind). Man
kann auch an jeder Stelle, die ein Argument erfordert, explizit angeben, welches Argument verwendet wird,
indem man »%m$« anstelle von '%' und »*m$« anstelle von '*' schreibt, wobei die Dezimalzahl m die
Position des gewünschten Arguments in der Argumentliste angibt, beginnend mit 1. Damit sind

printf("%*d", width, num);

und

printf("%2$*1$d", width, num);

gleichwertig. Die zweite Form ermöglicht wiederholte Referenzen auf das gleiche Argument. Der
C99-Standard schließt die aus der Single Unix Specification stammende Form mit '$' nicht mit ein. Wenn
die '$' verwendende Form eingesetzt wird, muss sie durchgehend für alle Umwandlungen, die ein Argument
erfordern, und alle Breiten- und Genauigkeitsargumente verwendet werden, darf aber mit »%%«-Formaten (die
kein Argument erfordern) vermischt werden. Es darf keine Lücken in der Zahl der mittels '$'
spezifizierten Argumente geben; beispielsweise muss, wenn die Argumente 1 und 3 angegeben werden, auch
Argument 2 irgendwo im Formatstring erwähnt werden.

Für einige numerische Umwandlungen wird ein Radixzeichen (»Dezimalpunkt«) oder ein
Tausender-Gruppierungszeichen verwendet. Das tatsächlich benutzte Zeichen hängt von der
LC_NUMERIC-Komponente der Locale ab. Die POSIX-Locale benutzt '.' als Radixzeichen und hat kein
Gruppierungszeichen. Damit resultiert

printf("%'.2f", 1234567.89);

in »1234567.89« in der POSIX-Locale, in »1234567,89« in der Locale nl_NL und in »1.234.567,89« in der
Locale da_DK.

Die Zeichen für die Flags (Schalter)
Dem Zeichen % folgen null oder mehr der folgenden Flags:

# Der Wert soll in eine »alternative Form« gewandelt werden. Bei o-Umwandlungen ist das erste
Zeichen der Ausgabe eine Null (indem eine »0« vorangestellt wird, wenn der Wert nicht schon Null
war). Bei den Umwandlungen x und X wird einem Ergebnis ungleich Null die Zeichenkette »0x« (oder
»0X« bei X) vorangestellt. Bei den Umwandlungen a, A, e, E, f, F, g und G enthält das Ergebnis
immer ein Dezimaltrennzeichen, auch wenn ihm keine Ziffern folgen. (Normalerweise tritt ein
Dezimaltrennzeichen nur in Ergebnissen auf, wenn ihm eine Ziffer folgt.) Bei den Umwandlungen g
und G werden nachfolgende Nullen nicht aus dem Ergebnis entfernt, wie sie es normalerweise würden.
Für andere Umwandlungen ist das Ergebnis nicht definiert.

0 Der Wert soll mit Nullen aufgefüllt werden. Bei den Umwandlungen d, i, o, u, x, X, a, A, e, E, f,
F, g und G wird der umgewandelte Wert links mit Nullen anstatt mit Leerzeichen aufgefüllt. Werden
sowohl 0 als auch - angegeben, so wird 0 ignoriert. Wenn eine Genauigkeit bei einer numerischen
Umwandlung (d, i, o, u, x und X) angegeben ist, wird das Flag 0 ignoriert. Für andere Umwandlungen
ist das Ergebnis nicht definiert.

- Der umgewandelte Wert soll linksbündig an der Feldgrenze ausgerichtet werden. (Standard ist
rechtsbündige Ausrichtung.) Außer bei der Umwandlung n wird der umgewandelte Wert rechts mit
Leerzeichen aufgefüllt statt links mit Leerzeichen oder Nullen. Ein - übersteuert ein 0, falls
beide angegeben sind.

' ' (ein Leerzeichen) Vor einer positiven Zahl (oder einer leeren Zeichenkette), die durch eine
vorzeichenbehaftete Umwandlung mit erzeugt wurde, soll ein Leerzeichen erhalten bleiben.

+ Vor jeder durch eine vorzeichenbehaftete Umwandlung erzeugten Zahl soll ein Vorzeichen (+ oder -)
platziert werden. Standardmäßig wird ein Vorzeichen nur für negative Zahlen verwendet. Ein +
übersteuert ein Leerzeichen, falls beide verwendet werden.

Die obigen fünf Flags werden vom C-Standard definiert. SUSv2 spezifiziert ein weiteres Flag.

' gibt für dezimale Umwandlungen (i, d, u, f, F, g, G) an, dass die Ausgabe mit dem
Tausender-Gruppierungszeichen gruppiert werden soll, wenn die Locale-Information eines angibt.
Beachten Sie, dass viele Versionen von gcc(1) diese Option nicht auswerten können und eine Warnung
ausgeben werden. SUSv2 schließt %'F nicht mit ein.

Glibc 2.2 fügt ein weiteres Flag-Zeichen hinzu.

I Für dezimale Integer-Umwandlungen (i, d, u) benutzt die Ausgabe die alternativen Ausgabeziffern
der Locale, wenn es solche gibt. Beispielsweise bewirkt diese Option seit Glibc 2.2.3
arabisch-indische Ziffern in der persischen (»fa_IR«) Locale.

Die Feldbreite
Diese optionale Dezimalzahl gibt die minimale Feldbreite an; die erste Ziffer ist von Null verschieden.
Wenn der umgewandelte Wert weniger Zeichen als die Feldbreite hat, wird er links mit Leerzeichen
aufgefüllt (oder rechts, wenn das Flag für Linksbündigkeit gesetzt ist). Statt einer Dezimalzahl kann
auch »*« oder »*m$« (für irgendeine Integerzahl m) angegeben werden, um zu spezifizieren, dass die
Feldbreite im nächsten (oder m-ten) Argument gegeben ist, welches vom Type int sein muss. Eine negative
Feldbreite wird als Flag '-' gefolgt von einer positiven Breite interpretiert. In keinem Fall bewirkt
eine fehlende oder kleine Feldbreite das Abschneiden eines Feldes; ist das Ergebnis einer Umwandlung
breiter als die Feldbreite, so wird das Feld erweitert, um das Ergebnis aufzunehmen.

Die Genauigkeit
An optional precision, in the form of a period ('.') followed by an optional decimal digit string.
Instead of a decimal digit string one may write "*" or "*m$" (for some decimal integer m) to specify that
the precision is given in the next argument, or in the m-th argument, respectively, which must be of type
int. If the precision is given as just '.', the precision is taken to be zero. A negative precision is
taken as if the precision were omitted. This gives the minimum number of digits to appear for d, i, o, u,
x, and X conversions, the number of digits to appear after the radix character for a, A, e, E, f, and F
conversions, the maximum number of significant digits for g and G conversions, or the maximum number of
characters to be printed from a string for s and S conversions.

Der Längenmodifikator
Im Folgenden steht »Ganzzahlumwandlung« für d, i, o, u, x oder X.

hh Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ signed char oder unsigned char
oder eine folgende n-Umwandlung entspricht einem Zeiger auf ein signed char-Argument.

h Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ short int oder unsigned short
int oder eine folgende n-Umwandlung entspricht einem Zeiger auf ein short int-Argument.

l (ell) Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ long int oder unsigned
long int oder eine folgende n-Umwandlung entspricht einem Zeiger auf ein long int-Argument oder
eine folgende c-Umwandlung entspricht einem wint_t-Argument oder eine folgende s-Umwandlung
entspricht einem Zeiger auf ein wchar_t-Argument.

ll (ell-ell) Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ long long int oder
unsigned long long int oder eine folgende n-Umwandlung entspricht einem Zeiger auf ein long long
int-Argument.

L Eine folgende a-, A-, e-, E-, f-, F-, g- oder G-Umwandlung entspricht einem long double-Argument.
(C99 erlaubt %LF, aber SUSv2 nicht.)

q (»quad«. Nur 4.4BSD und Linux Libc5. Nicht benutzen.) Dies ist ein Synonym für ll.

j Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ intmax_t oder uintmax_t.

z Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ size_t oder ssize_t. (Linux
Libc5 verwendet Z mit dieser Bedeutung. Nicht benutzen.)

t Eine folgende Ganzzahlumwandlung entspricht einem Argument vom Typ ptrdiff_t.

SUSv2 kennt nur die Längenmodifikatoren h (in hd, hi, ho, hx, hX, hn) und l (in ld, li, lo, lx, lX, ln,
lc, ls) und L (in Le, LE, Lf, Lg, LG).

Das Umwandlungssymbol
Ein Zeichen, das den Typ der anzuwendenden Umwandlung angibt. Die Umwandlungssymbole und ihre Bedeutung
sind:

d, i Das int-Argument wird umgewandelt in eine vorzeichenbehaftete Dezimalzahl. Die Genauigkeit, sofern
vorhanden, gibt die minimale Anzahl von Ziffern an, die auftreten muss; wenn der umgewandelte Wert
weniger Ziffern benötigt, wird er links mit Nullen aufgefüllt. Die voreingestellte Genauigkeit ist
1. Wird 0 mit einer expliziten Genauigkeit 0 gedruckt, so ist die Ausgabe leer.

o, u, x, X
Das unsigned int-Argument wird in eine vorzeichenlose Oktal- (o), Dezimal- (u) oder
Hexadezimalzahl (x und X) umgewandelt. Die Buchstaben abcdef werden für x-Umwandlungen benutzt;
die Buchstaben ABCDEF für X-Umwandlungen. Die Genauigkeit, sofern vorhanden, gibt die minimale
Anzahl vor Ziffern an, die auftreten muss; wenn der umgewandelte Wert weniger Ziffern benötigt,
wird er links mit Nullen aufgefüllt. Die voreingestellte Genauigkeit ist 1. Wird 0 mit einer
expliziten Genauigkeit 0 gedruckt, so ist die Ausgabe leer.

e, E Das double-Argument wird gerundet und in die Form [-]d.ddde+-dd umgewandelt, wobei eine Ziffer vor
dem Dezimaltrennzeichen erscheint und die Anzahl der Ziffern dahinter der Genauigkeit entspricht;
falls die Genauigkeit fehlt, wird sie als 6 angenommen; falls die Genauigkeit Null ist, erscheint
kein Dezimaltrennzeichen. Eine E-Umwandlung verwendet den Buchstaben E (in Gegensatz zu e), um den
Exponenten einzuleiten. Der Exponent enthält immer mindestens zwei Ziffern; falls der Wert Null
ist, ist der Exponent 00.

f, F Das double-Argument wird gerundet und umgewandelt in dezimale Notation im Format [-]ddd.ddd, wobei
die Anzahl der Ziffern hinter dem Dezimaltrennzeichen der vorgegebenen Genauigkeit entspricht.
Falls die Genauigkeit fehlt, wird sie als 6 angenommen; falls die Genauigkeit Null ist, erscheint
kein Dezimaltrennzeichen. Falls ein Dezimaltrennzeichen erscheint, befindet sich mindestens eine
Ziffer davor.

(SUSv2 kennt F nicht und besagt, dass Zeichenketten-Darstellungen für Unendlich und NaN (Not a
Number - keine Zahl) verfügbar gemacht werden können. Der C99-Standard spezifiziert »[-]inf« oder
»[-]infinity« für Unendlich sowie eine Zeichenkette beginnend mit »nan« für NaN im Falle von f und
entsprechen »[-]INF« oder »[-]INFINITY« oder »NAN« im Falle von F.)

g, G Das double-Argument wird umgewandelt in das Format f oder e (oder F oder E für die G-Umwandlung).
Die Genauigkeit gibt die Anzahl der signifikanten Stellen an. Falls die Genauigkeit fehlt, werden
6 Ziffern zurückgegeben; falls die Genauigkeit Null ist, wird sie als 1 angenommen. Form e wird
benutzt, falls der Exponent kleiner als -4 oder größer als oder gleich der Genauigkeit ist.
Abschließende Nullen in den Nachkommastellen werden entfernt; ein Dezimaltrennzeichen erscheint
nur, wenn es von mindestens einer Ziffer gefolgt wird.

a, A (C99; nicht in SUSv2) Für die a-Umwandlung wird das double-Argument (unter Verwendung der
Buchstaben abcdef) in hexadezimale Notation der Form [-]0xh.hhhhp± gebracht; für A werden dagegen
der Präfix 0X, die Buchstaben ABCDEF und das Exponententrennzeichen P verwendet. Vor dem
Dezimaltrennzeichen steht eine hexadezimale Ziffer, die Anzahl der Stellen dahinter entspricht der
Genauigkeit. Die standardmäßige Genauigkeit genügt für eine exakte Darstellung des Wertes, wenn
eine exakte Darstellung zur Basis 2 existiert und ist sonstigenfalls groß genug, um Werte vom Typ
double zu unterscheiden. Die Ziffer vor dem Dezimaltrennzeichen ist unspezifiziert für nicht
normalisierte Zahlen, und für normalisierte Zahlen nicht Null, aber ansonsten unspezifiziert.

c Wenn kein Modifikator l vorhanden ist, wird das int-Argument umgewandelt in einen unsigned char
und das resultierende Zeichen ausgegeben. Wenn ein l vorhanden ist, wird das wint_t-Argument (wide
character) mit einem Aufruf der Funktion wcrtomb(3) zu einer Multibyte-Folge umgewandelt, mit der
Konvertierung beginnend im initialen Zustand, und die resultierende Multibyte-Zeichenkette wird
ausgegeben.

s Wenn kein Modifikator l vorhanden ist, wird das const char *-Argument erwartet als ein Zeiger auf
ein Feld vom Typ Zeiger (Zeiger auf eine Zeichenkette). Zeichen aus diesem Feld werden bis zu
(aber nicht einschließlich) des terminierenden Null-Bytes ('\0') ausgegeben; wenn eine Genauigkeit
angegeben ist, werden nicht mehr Zeichen als die angegebene Anzahl ausgegeben. Wenn eine
Genauigkeit angegeben ist braucht kein Null-Byte vorhanden zu sein; wenn die Genauigkeit nicht
angegeben ist oder größer als das Feld ist, muss das Feld ein abschließendes Null-Byte enthalten.

Wenn ein l vorhanden ist, wird das const wchar_t *-Argument als ein Zeiger auf ein Feld von wide
characters erwartet. Wide characters aus dem Feld werden zu Multibyte-Zeichen umgewandelt (jedes
mit einem Aufruf der Funktion wcrtomb(3), beginnend im initialen Zustand vor dem ersten wide
character), bis zu und einschließlich des terminierenden wchar_t-Null-Zeichens. Die resultierenden
Multibyte-Zeichen werden bis zum (aber nicht einschließlich) des abschließenden Null-Bytes
geschrieben. Falls eine Genauigkeit angegeben ist, werden nicht mehr Bytes als die angegebene
Anzahl ausgegeben, aber es werden keine partiellen Multibyte-Zeichen ausgegeben. Man beachte, dass
die Genauigkeit die Anzahl der geschriebenen Bytes angibt, nicht die Anzahl der wide characters
oder Bildschirmpositionen. Das Feld muss ein terminierendes wchar_t-Null-Zeichen enthalten, wenn
nicht eine Genauigkeit gegeben ist, die so klein ist, dass die Zahl der geschriebenen Bytes sie
übersteigt, bevor das Ende des Feldes erreicht ist.

C (Nicht in C99, aber in SUSv2.) Synonym für lc. Nicht verwenden.

S (Nicht in C99, aber in SUSv2.) Synonym für ls. Nicht verwenden.

p Das void *-Zeiger-Argument wird hexadezimal ausgegeben (wie bei %#x oder %#lx).

n Die Anzahl der bisher ausgegebenen Zeichen wird in dem Integer gespeichert, der durch das
int *-Zeiger-Argument (bzw. ein Äquivalent) gegeben ist. Es wird kein Argument umgewandelt.

m (Glibc-Erweiterung) Gibt die Ausgabe von strerror(errno) aus; kein Argument erforderlich.

% Es wird ein '%' ausgegeben. Es wird kein Argument umgewandelt. Die vollständige
Umwandlungsanweisung ist '%%'.

KONFORM ZU

       Die  Funktionen fprintf(), printf(), sprintf(), vprintf(), vfprintf(), und vsprintf() sind konform zu C89
       und C99. Die Funktionen snprintf() und vsnprintf() sind konform zu C99.

       Hinsichtlich des Rückgabewerts von  snprintf()  widersprechen  sich  SUSv2  und  der  C99-Standard:  wird
       snprintf()  mit size=0 aufgerufen, dann fordert SUSv2 einen nicht spezifizierten Rückgabewert kleiner als
       1, während C99 es zulässt, dass str in diesem Fall NULL ist, und (wie immer)  den  Rückgabewert  als  die
       Anzahl der Zeichen angibt, die bei ausreichend großer Ausgabe-Zeichenkette geschrieben worden wären.

       Linux Libc4 kennt die fünf C-Standardschalter, die Längenmodifikatoren h, l, L und die Umwandlungen c, d,
       e,  E, f, F, g, G, i, n, o, p, s, u, x und X, wobei F ein Synonym für f ist. Zusätzlich akzeptiert sie D,
       O und U als synonyme für ld, lo und lu. (Das ist schlecht und verursachte später schwere Fehler, als  die
       Unterstützung   für   %D   auslief.)  Sie  kennt  kein  von  der  Locale  abhängiges  Radixzeichen,  kein
       Tausender-Trennzeichen, kein NaN oder Unendlich und schließlich auch nicht »%m$« and »*m$«.

       Linux Libc5 kennt die fünf C-Standardschalter, den '-Schalter, Locale, »%m$« und  »*m$«.  Sie  kennt  die
       Längenmodifikatoren  h,  l, L, Z und q, akzeptiert aber L und q sowohl für long double als auch long long
       int (das ist ein Fehler). Sie erkennt F, D, O und U nicht mehr, fügt aber ein neues  Umwandlungssymbol  m
       hinzu, welches strerror(errno) ausgibt.

       Glibc 2.0 fügt die Umwandlungszeichen C und S hinzu.

       Glibc 2.1 fügt die Längenmodifikatoren hh, j, t und z sowie die Umwandlungszeichen a und A hinzu.

       Glibc 2.2 fügt das Umwandlungszeichen F mit C99-Semantik sowie den Schalter l hinzu.

ANMERKUNGEN

       Einige Programme verlassen sich leichtsinnig auf Code wie den folgenden

          sprintf(buf, "%s etwas mehr Text", buf);

       um  Text  an  buf  anzuhängen.  Jedoch  weisen  die  Standards  explizit  darauf hin, dass die Ergebnisse
       undefiniert sind, wenn Quell- und Ziel-Puffer beim  Aufruf  von  sprintf(),  snprintf(),  vsprintf()  und
       vsnprintf()  überlappen.  Abhängig von der verwendeten gcc(1)-Version und den gewählten Compiler-Optionen
       erzeugen Aufrufe wie das obige Beispiel nicht die erwarteten Ergebnisse.

       Seit der Glibc-Version 2.1 ist die Implementierung der Funktionen snprintf() und vsnprintf()  konform  zu
       C99,  verhält  sich  also  wie  oben beschrieben. Bis Glibc 2.0.6 gaben sie im Fall gekürzter Ausgaben -1
       zurück.

FEHLER

       Da sprintf() und vsprintf() eine beliebig lange Zeichenkette annehmen, müssen Aufrufende  darauf  achten,
       nicht  den  tatsächlich  verfügbaren  Platz zu überschreiten; dies ist oft unmöglich sicherzustellen. Man
       beachte, dass die Länge der Zeichenketten oft abhängig von der Locale und schwierig  vorherzusagen  sind.
       Benutzen Sie stattdessen snprintf() und vsnprintf() (oder asprintf(3) und vasprintf(3)).

       Linux  Libc4.[45]  verfügt  nicht  über  eine  snprintf(),  stellt  aber  eine  libbsd  bereit,  die  ein
       snprintf()-Äquivalent zu sprintf() enthält. Diese Version ignoriert das Argument size.  Somit  führt  die
       Verwendung von snprintf() mit frühen Libc4-Versionen zu schweren Sicherheitsproblemen.

       Code  wie beispielsweise printf(foo); weist häufig auf einen Fehler hin, da foo das Zeichen »%« enthalten
       kann. Stammt foo von ungeprüfter Nutzereingabe, kann es »%n« enthalten und veranlasst  printf(),  in  den
       Speicher zu schreiben und erzeugt damit ein Sicherheitsloch.

BEISPIEL

       Um Pi mit fünf Dezimalstellen auszugeben:

           #include <math.h>
           #include <stdio.h>
           fprintf(stdout, "pi = %.5f\n", 4 * atan(1.0));

       Um  Datum  und  Zeit  in  der Form `Sunday, July 3, 10:02' auszugeben, wobei weekday und month Zeiger auf
       Zeichenketten sind:

           #include <stdio.h>
           fprintf(stdout, "%s, %s %d, %.2d:%.2d\n",
                   weekday, month, day, hour, min);

       Die meisten Länder verwenden die  Reihenfolge  Tag-Monat-Jahr.  Deshalb  muss  eine  internationalisierte
       Version in der Lage sein, die Argumente in der durch das Format angegebenen Reihenfolge zu drucken:

           #include <stdio.h>
           fprintf(stdout, format,
                   weekday, month, day, hour, min);

       wobei format von der Locale abhängt und möglicherweise die Argumente permutiert. Mit dem Wert

           "%1$s, %3$d. %2$s, %4$d:%5$.2d\n"

       könnte dann »Sonntag, 3. Juli, 10:02« dabei herauskommen.

       Um  eine genügend große Zeichenkette bereitzustellen und in sie zu schreiben (der Code ist korrekt sowohl
       für Glibc 2.0 als auch Glibc 2.1):

       If truncation occurs in glibc versions prior to 2.0.6, this is treated  as  an  error  instead  of  being
       handled gracefully.

       #include <stdio.h>
       #include <stdlib.h>
       #include <stdarg.h>

       char *
       make_message(const char *fmt, ...)
       {
           int n;
           int size = 100;     /* Annahme: Wir brauchen nicht mehr als
                                         100 Byte. */
           char *p, *np;
           va_list ap;

           if ((p = malloc(size)) == NULL)
               return NULL;

           while (1) {

               /* Versuch, in den bereitgestellten Speicherplatz zu schreiben. */

               va_start(ap, fmt);
               n = vsnprintf(p, size, fmt, ap);
               va_end(ap);

               /* Fehlercode prüfen */

               if (n < 0)
                   return NULL;

               /* Wenn das geklappt hat, die Zeichenkette zurückgeben. */

               if (n < size)
                   return p;

               /* anderenfalls mit mehr Platz nochmals versuchen */

               size = n + 1;       /* Genau was benötigt wird */

               if ((np = realloc (p, size)) == NULL) {
                   free(p);
                   return NULL;
               } else {
                   p = np;
               }
           }
       }

SIEHE AUCH

       printf(1), asprintf(3), dprintf(3), scanf(3), setlocale(3), wcrtomb(3), wprintf(3), locale(5)

KOLOPHON

       This  page  is  part  of  release  3.54 of the Linux man-pages project. A description of the project, and
       information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
       erstellt.

       Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 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
       <debian-l10n-german@lists.debian.org>.

GNU                                             4. September 2013                                      PRINTF(3)