snprintf() w bibliotece C
The funkcja snprintf(). jest zdefiniowany w nagłówkowy i służy do przechowywania określonego ciągu do określonej długości w określonym formacie.
Charakterystyka metody snprintf():
- Funkcja snprintf() formatuje i przechowuje serię znaków i wartości w buforze tablicy.
- Funkcja snprintf() przyjmuje argument „n”, który wskazuje maksymalną liczbę znaków (w tym na końcu znaku null), które można zapisać w buforze.
- Funkcja snprintf() służy do przekierowania danych wyjściowych funkcji printf() do bufora.
- Funkcja snprintf() zwraca również liczbę znaków, które miały zostać zapisane w buforze (z wyłączeniem terminatora zerowego), niezależnie od przekazanej wartości „n”.
- Zatem tylko wtedy, gdy zwrócona wartość jest nieujemna i mniejsza niż „n”, ciąg znaków został zapisany w całości zgodnie z oczekiwaniami.
Składnia: Składnia metody snprintf() jest następująca:
int snprintf(char *str, size_t size, const char *format, …);
Parametry:
- *str: jest buforem. size : to maksymalna liczba bajtów (znaków), które zostaną zapisane w buforze. format : ciąg C zawierający ciąg formatujący zgodny z tymi samymi specyfikacjami, co format w printf… : the opcjonalne (...) argumenty to tylko formaty ciągów, takie jak (%d, myint), jak widać w printf.
Wartość zwracana:
- Liczba znaków, które zostałyby zapisane w buforze, gdyby „n” było wystarczająco duże. Kończący znak null nie jest liczony.
- Jeśli wystąpi błąd kodowania, zwracana jest liczba ujemna.
Poniżej znajduje się przykład ilustrujący działanie metody snprintf():
Przykład 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;> }> |
Wyjście
Writing geeksforgeeks onto buffer with capacity 6 String written on buffer = geeks Value returned by snprintf() method = 14
Przykład 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;> }> |
Wyjście
The number of bytes printed to 'buffer' (excluding the null terminator) is 45 Joined string: The quick brown fox jumped over the lazy dog.