printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s
| Definiert in Header <stdio.h> |
||
| (1) | ||
| int printf( const char* format, ... ); |
(bis C99) | |
| int printf( const char* restrict format, ... ); |
(seit C99) | |
| (2) | ||
| int fprintf( FILE* stream, const char* format, ... ); |
(bis C99) | |
| int fprintf( FILE* restrict stream, const char* restrict format, ... ); |
(seit C99) | |
| (3) | ||
| int sprintf( char* buffer, const char* format, ... ); |
(bis C99) | |
| int sprintf( char* restrict buffer, const char* restrict format, ... ); |
(seit C99) | |
| int snprintf( char* restrict buffer, size_t bufsz, const char* restrict format, ... ); |
(4) | (seit C99) |
| int printf_s( const char* restrict format, ... ); |
(5) | (seit C11) |
| int fprintf_s( FILE* restrict stream, const char* restrict format, ... ); |
(6) | (seit C11) |
| int sprintf_s( char* restrict buffer, rsize_t bufsz, const char* restrict format, ... ); |
(7) | (seit C11) |
| int snprintf_s( char* restrict buffer, rsize_t bufsz, const char* restrict format, ... ); |
(8) | (seit C11) |
Lädt die Daten von den angegebenen Speicherorten, konvertiert sie in Zeichenkettenäquivalente und schreibt die Ergebnisse in eine Vielzahl von Senken/Streams
- der Konvertierungsspezifizierer
%nim format vorhanden ist - eines der Argumente, die
%sentsprechen, ein Nullzeiger ist - stream oder format oder buffer ist ein Nullzeiger
- bufsz ist null oder größer als RSIZE_MAX
- bei der Konvertierung von Zeichenketten und Zeichenspezifizierern Kodierungsfehler auftreten
- (nur für
sprintf_s) würde die Zeichenkette, die in buffer gespeichert werden soll (einschließlich des abschließenden Nullzeichens), bufsz überschreiten.
- der Konvertierungsspezifizierer
- Wie bei allen grenzgeprüften Funktionen sind
printf_s,fprintf_s,sprintf_sundsnprintf_snur dann garantiert verfügbar, wenn __STDC_LIB_EXT1__ von der Implementierung definiert ist und wenn der Benutzer __STDC_WANT_LIB_EXT1__ auf die Ganzzahlkonstante 1 setzt, bevor <stdio.h> eingebunden wird.
Inhalt |
[edit] Parameter
| stream | - | Ausgabestream, in den geschrieben werden soll |
| buffer | - | Zeiger auf eine Zeichenkette, in die geschrieben werden soll |
| bufsz | - | bis zu bufsz - 1 Zeichen dürfen geschrieben werden, plus der Nullterminator |
| format | - | Zeiger auf eine nullterminierte Byte-Zeichenkette, die angibt, wie die Daten zu interpretieren sind |
| ... | - | Argumente, die die zu druckenden Daten angeben. Wenn ein Argument nach den Standard-Argument-Promotions nicht dem erwarteten Typ des entsprechenden Konvertierungsspezifikators entspricht (der erwartete Typ ist der promovierte Typ oder ein damit kompatibler Typ des promovierten Typs), oder wenn weniger Argumente vorhanden sind als von format gefordert, ist das Verhalten undefiniert. Wenn mehr Argumente vorhanden sind als von format gefordert, werden die überschüssigen Argumente ausgewertet und ignoriert. |
Die format-Zeichenkette besteht aus gewöhnlichen Byte-Zeichen (außer %), die unverändert in den Ausgabestrom kopiert werden, und Konversionsspezifikationen. Jede Konversionsspezifikation hat das folgende Format:
- ein einführendes
%-Zeichen.
- ein einführendes
- (optional) ein oder mehrere Flags, die das Verhalten der Konversion modifizieren
-
-: Das Ergebnis der Konversion wird im Feld linksbündig ausgerichtet (standardmäßig rechtsbündig). -
+: Das Vorzeichen von Vorzeichenkonversionen wird immer dem Ergebnis der Konversion vorangestellt (standardmäßig wird dem Ergebnis nur dann ein Minus vorangestellt, wenn es negativ ist). - Leerzeichen: Wenn das Ergebnis einer Vorzeichenkonversion nicht mit einem Vorzeichen beginnt oder leer ist, wird dem Ergebnis ein Leerzeichen vorangestellt. Es wird ignoriert, wenn das Flag
+vorhanden ist. -
#: Eine alternative Form der Konversion wird durchgeführt. Die genauen Effekte sind in der untenstehenden Tabelle aufgeführt, andernfalls ist das Verhalten undefiniert. -
0: Bei Ganzzahl- und Gleitkommazahlenkonversionen werden die Felder mit Nullen aufgefüllt anstelle von Leerzeichen. Bei Ganzzahlen wird dies ignoriert, wenn die Genauigkeit explizit angegeben ist. Bei anderen Konversionen führt die Verwendung dieses Flags zu undefiniertem Verhalten. Es wird ignoriert, wenn das Flag-vorhanden ist.
-
- (optional) Ganzzahlwert oder
*, der die minimale Feldbreite angibt. Das Ergebnis wird mit Leerzeichen (standardmäßig) aufgefüllt, falls erforderlich, links bei rechtsbündiger Ausrichtung oder rechts bei linksbündiger Ausrichtung. Wenn*verwendet wird, wird die Breite durch ein zusätzliches Argument vom Typ int angegeben, das vor dem zu konvertierenden Argument und dem Argument für die Präzision (falls vorhanden) steht. Wenn der Wert des Arguments negativ ist, führt dies zur Angabe des-Flags und einer positiven Feldbreite (Hinweis: Dies ist die minimale Breite: Der Wert wird nie gekürzt).
- (optional) Ganzzahlwert oder
- (optional)
.gefolgt von einer Ganzzahl oder*, oder weder noch, das die Präzision der Konvertierung angibt. Wenn*verwendet wird, wird die Präzision durch ein zusätzliches Argument vom Typ int angegeben, das vor dem zu konvertierenden Argument steht, aber nach dem Argument für die minimale Feldbreite (falls vorhanden). Wenn der Wert dieses Arguments negativ ist, wird es ignoriert. Wenn weder eine Zahl noch*verwendet wird, wird die Präzision als Null angenommen. Die genauen Auswirkungen der Präzision finden Sie in der folgenden Tabelle.
- (optional)
- (optional) Ein Längenmodifikator, der die Größe des Arguments angibt (in Kombination mit dem Konversionsformat-Spezifizierer gibt er den Typ des entsprechenden Arguments an).
- Ein Konversionsformat-Spezifizierer.
Die folgenden Format-Spezifizierer sind verfügbar:
| Konversion Spezifizierer |
Erklärung | Erwartet Argumenttyp | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Längenmodifikator → | hh | h | keine | l | ll | j | z | t | L | |
| Nur verfügbar seit C99 → | Ja | Ja | Ja | Ja | Ja | |||||
%
|
Schreibt ein literales %. Die vollständige Konversionsspezifikation muss %% sein. |
N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
c
|
Schreibt ein einzelnes Zeichen.
|
N/A | N/A | int |
wint_t |
N/A | N/A | N/A | N/A | N/A |
s
|
Schreibt eine Zeichenkette.
|
N/A | N/A | char* |
wchar_t* |
N/A | N/A | N/A | N/A | N/A |
di
|
Konvertiert eine vorzeichenbehaftete Ganzzahl in die Dezimaldarstellung [-]dddd.
|
signed char |
short |
int |
long |
long long |
※ |
N/A | ||
o
|
Konvertiert eine vorzeichenlose Ganzzahl in die Oktaldarstellung oooo.
|
unsigned char |
unsigned short |
unsigned int |
unsigned long |
unsigned long long |
vorzeichenbehaftete Version von ptrdiff_t |
N/A | ||
xX
|
Konvertiert eine vorzeichenlose Ganzzahl in die Hexadezimaldarstellung hhhh.
|
N/A | ||||||||
u
|
Konvertiert eine vorzeichenlose Ganzzahl in die Dezimaldarstellung dddd.
|
N/A | ||||||||
fF (C99)
|
Konvertiert eine Gleitkommazahl in die Dezimalnotation im Stil [-]ddd.ddd.
|
N/A | N/A | double |
double (C99) |
N/A | N/A | N/A | N/A | long double |
eE
|
Konvertiert eine Gleitkommazahl in die Dezimal-Exponent-Notation.
|
N/A | N/A | N/A | N/A | N/A | N/A | |||
aA
(C99) |
Konvertiert eine Gleitkommazahl in die Hexadezimal-Exponent-Notation.
|
N/A | N/A | N/A | N/A | N/A | N/A | |||
gG
|
Konvertiert eine Gleitkommazahl je nach Wert und Genauigkeit in die Dezimal- oder Dezimal-Exponent-Notation.
|
N/A | N/A | N/A | N/A | N/A | N/A | |||
n
|
Gibt die bisher von diesem Funktionsaufruf geschriebene Anzahl der Zeichen zurück.
|
signed char* |
short* |
int* |
long* |
long long* |
※ |
N/A | ||
p
|
Schreibt eine implementierungsdefinierte Zeichensequenz, die einen Zeiger darstellt. |
N/A | N/A | void* |
N/A | N/A | N/A | N/A | N/A | N/A |
| Anmerkungen | ||||||||||
|
Die Gleitkommakonversionsfunktionen konvertieren Unendlichkeit in Nicht-Zahlen werden in Die Konversionen Der Konvertierungsspezifikator, der zum Drucken von char, unsigned char, signed char, short und unsigned short verwendet wird, erwartet die promovierten Typen der Standard-Argument-Promotions, aber vor dem Drucken seines Wertes wird er in char, unsigned char, signed char, short und unsigned short konvertiert. Es ist sicher, Werte dieser Typen zu übergeben, aufgrund der Promotion, die stattfindet, wenn eine variadische Funktion aufgerufen wird. Die korrekten Konvertierungsspezifikationen für die festen Zeichentypen (int8_t, etc.) sind im Header <inttypes.h> definiert (obwohl PRIdMAX, PRIuMAX, etc. synonym mit Der Speicher schreibende Konvertierungsspezifizierer Nach der Ausführung jedes Konvertierungsspezifizierers gibt es einen Sequenzpunkt; dies ermöglicht es, mehrere Wenn eine Konversionsspezifikation ungültig ist, ist das Verhalten undefiniert. | ||||||||||
[edit] Rückgabewert
[edit] Hinweise
Der C-Standard und POSIX legen fest, dass das Verhalten von sprintf und seinen Varianten undefiniert ist, wenn sich ein Argument mit dem Zielpuffer überschneidet. Beispiel
sprintf(dst, "%s and %s", dst, t); // <- broken: undefined behavior
POSIX legt fest, dass errno bei Fehlern gesetzt wird. Es legt auch zusätzliche Konvertierungsspezifikationen fest, insbesondere die Unterstützung für Argumentreihenfolge (n$ unmittelbar nach % bezeichnet das n-te Argument).
Der Aufruf von snprintf mit null bufsz und einem Nullzeiger für buffer ist nützlich, um die erforderliche Puffergröße zur Aufnahme der Ausgabe zu ermitteln.
snprintf_s, genau wie snprintf, aber im Gegensatz zu sprintf_s, schneidet die Ausgabe ab, damit sie in bufsz - 1 passt.
[edit] Beispiel
#include <inttypes.h> #include <stdint.h> #include <stdio.h> int main(void) { const char* s = "Hello"; printf("Strings:\n"); // same as puts("Strings"); printf(" padding:\n"); printf("\t[%10s]\n", s); printf("\t[%-10s]\n", s); printf("\t[%*s]\n", 10, s); printf(" truncating:\n"); printf("\t%.4s\n", s); printf("\t%.*s\n", 3, s); printf("Characters:\t%c %%\n", 'A'); printf("Integers:\n"); printf("\tDecimal:\t%i %d %.6i %i %.0i %+i %i\n", 1, 2, 3, 0, 0, 4,-4); printf("\tHexadecimal:\t%x %x %X %#x\n", 5, 10, 10, 6); printf("\tOctal:\t\t%o %#o %#o\n", 10, 10, 4); printf("Floating-point:\n"); printf("\tRounding:\t%f %.0f %.32f\n", 1.5, 1.5, 1.3); printf("\tPadding:\t%05.2f %.2f %5.2f\n", 1.5, 1.5, 1.5); printf("\tScientific:\t%E %e\n", 1.5, 1.5); printf("\tHexadecimal:\t%a %A\n", 1.5, 1.5); printf("\tSpecial values:\t0/0=%g 1/0=%g\n", 0.0 / 0.0, 1.0 / 0.0); printf("Fixed-width types:\n"); printf("\tLargest 32-bit value is %" PRIu32 " or %#" PRIx32 "\n", UINT32_MAX, UINT32_MAX ); }
Mögliche Ausgabe
Strings:
padding:
[ Hello]
[Hello ]
[ Hello]
truncating:
Hell
Hel
Characters: A %
Integers:
Decimal: 1 2 000003 0 +4 -4
Hexadecimal: 5 a A 0x6
Octal: 12 012 04
Floating-point:
Rounding: 1.500000 2 1.30000000000000004440892098500626
Padding: 01.50 1.50 1.50
Scientific: 1.500000E+00 1.500000e+00
Hexadecimal: 0x1.8p+0 0X1.8P+0
Special values: 0/0=-nan 1/0=inf
Fixed-width types:
Largest 32-bit value is 4294967295 or 0xffffffff[edit] Referenzen
- C23-Standard (ISO/IEC 9899:2024)
- 7.21.6.1 Die fprintf-Funktion (S: TBD)
- 7.21.6.3 Die printf-Funktion (S: TBD)
- 7.21.6.5 Die snprintf-Funktion (S: TBD)
- 7.21.6.6 Die sprintf-Funktion (S: TBD)
- K.3.5.3.1 Die fprintf_s-Funktion (S: TBD)
- K.3.5.3.3 Die printf_s-Funktion (S: TBD)
- K.3.5.3.5 Die snprintf_s-Funktion (S: TBD)
- K.3.5.3.6 Die sprintf_s-Funktion (S: TBD)
- C17-Standard (ISO/IEC 9899:2018)
- 7.21.6.1 Die fprintf-Funktion (S: 225-230)
- 7.21.6.3 Die printf-Funktion (S: 236)
- 7.21.6.5 Die snprintf-Funktion (S: 237)
- 7.21.6.6 Die sprintf-Funktion (S: 237)
- K.3.5.3.1 Die fprintf_s-Funktion (S: 430)
- K.3.5.3.3 Die printf_s-Funktion (S: 432)
- K.3.5.3.5 Die snprintf_s-Funktion (S: 432-433)
- K.3.5.3.6 Die sprintf_s-Funktion (S: 433)
- C11-Standard (ISO/IEC 9899:2011)
- 7.21.6.1 Die fprintf-Funktion (S: 309-316)
- 7.21.6.3 Die printf-Funktion (S: 324)
- 7.21.6.5 Die snprintf-Funktion (S: 325)
- 7.21.6.6 Die sprintf-Funktion (S: 325-326)
- K.3.5.3.1 Die fprintf_s-Funktion (S: 591)
- K.3.5.3.3 Die printf_s-Funktion (S: 593-594)
- K.3.5.3.5 Die snprintf_s-Funktion (S: 594-595)
- K.3.5.3.6 Die sprintf_s-Funktion (S: 595-596)
- C99-Standard (ISO/IEC 9899:1999)
- 7.19.6.1 Die fprintf-Funktion (S: 274-282)
- 7.19.6.3 Die printf-Funktion (S: 290)
- 7.19.6.5 Die snprintf-Funktion (S: 290-291)
- 7.19.6.6 Die sprintf-Funktion (S: 291)
- C89/C90-Standard (ISO/IEC 9899:1990)
- 4.9.6.1 Die fprintf-Funktion
- 4.9.6.3 Die printf-Funktion
- 4.9.6.5 Die sprintf-Funktion
[edit] Siehe auch
| (C95)(C95)(C95)(C11)(C11)(C11)(C11) |
gibt formatierte Weitzeichenausgaben nach stdout, an einen Dateistream oder in einen Puffer aus (Funktion) |
| (C99)(C11)(C11)(C11)(C11) |
gibt formatierte Ausgaben nach stdout, an einen Dateistream oder in einen Puffer aus mit variabler Argumentenliste (Funktion) |
| schreibt einen Zeichenstring in einen Dateistream (Funktion) | |
| (C11)(C11)(C11) |
liest formatierte Eingaben aus stdin, einem Dateistream oder einem Puffer (Funktion) |
| C++ Dokumentation für printf, fprintf, sprintf, snprintf
| |