snprintf() v knihovně C
The funkce snprintf(). je definován v hlavičkový soubor a používá se k uložení zadaného řetězce do zadané délky v zadaném formátu.
Charakteristika metody snprintf():
- Funkce snprintf() formátuje a ukládá řadu znaků a hodnot do vyrovnávací paměti pole.
- Funkce snprintf() přijímá argument ‚n‘, který označuje maximální počet znaků (včetně na konci znaku null), které mají být zapsány do vyrovnávací paměti.
- Funkce snprintf() se používá k přesměrování výstupu funkce printf() do vyrovnávací paměti.
- Funkce snprintf() také vrací číselné znaky, které měly být zapsány do vyrovnávací paměti (kromě null terminátoru), bez ohledu na předávanou hodnotu ‚n‘.
- Takže pouze v případě, že vrácená hodnota je nezáporná a menší než „n“, byl řetězec zcela zapsán podle očekávání.
Syntax: Syntaxe metody snprintf() je:
int snprintf(char *str, velikost_t velikost, const char *formát, …);
Parametry:
- *str : je vyrovnávací paměť. size : je maximální počet bajtů (znaků), které budou zapsány do vyrovnávací paměti. format : C řetězec, který obsahuje formátovací řetězec, který odpovídá stejným specifikacím jako formát v printf … : the nepovinné (…) argumenty jsou pouze formáty řetězců jako (%d, myint), jak je vidět v printf.
Návratová hodnota:
- Počet znaků, které by byly zapsány do vyrovnávací paměti, kdyby „n“ bylo dostatečně velké. Koncový znak null se nepočítá.
- Pokud dojde k chybě kódování, vrátí se záporné číslo.
Níže je uveden příklad pro ilustraci fungování metody snprintf():
Příklad 1:
C
// C program to demonstrate snprintf()> #include> int> main()> {> > char> buffer[50];> > char> * s => 'geeksforgeeks'> ;> > // Counting the character and storing> > // in buffer using snprintf> > printf> (> 'Writing %s onto buffer'> > ' with capacity 6'> ,> > s);> > int> j = snprintf(buffer, 6,> '%s
'> , s);> > // Print the string stored in buffer and> > // character count> > printf> (> '
String written on '> > 'buffer = %s'> , buffer);> > printf> (> '
Value returned by '> > 'snprintf() method = %d
'> , j);> > return> 0;> }> |
Výstup
Writing geeksforgeeks onto buffer with capacity 6 String written on buffer = geeks Value returned by snprintf() method = 14
Příklad 2:
C
// C program to demonstrate snprintf()> #include> int> main()> {> > char> buffer[50];> > > // join two or more strings> > char> * str1 => 'quick'> ;> > char> * str2 => 'brown'> ;> > char> * str3 => 'lazy'> ;> > int> max_len => sizeof> buffer;> > int> j = snprintf(buffer, max_len,> > 'The %s %s fox jumped over the %s dog.'> ,> > str1, str2, str3);> > printf> (> '
The number of bytes printed to 'buffer' '> > '(excluding the null terminator) is %d
'> ,> > j);> > if> (j>= max_len)> > fputs> (> 'Buffer length exceeded; string truncated'> ,> > stderr);> > puts> (> 'Joined string:'> );> > puts> (buffer);> > return> 0;> }> |
Výstup
The number of bytes printed to 'buffer' (excluding the null terminator) is 45 Joined string: The quick brown fox jumped over the lazy dog.