snprintf() у бібліотеці C
The функція snprintf(). визначається в заголовний файл і використовується для зберігання вказаного рядка до заданої довжини у вказаному форматі.
Характеристики методу snprintf():
- Функція snprintf() форматує та зберігає ряд символів і значень у буфері масиву.
- Функція snprintf() приймає аргумент «n», який вказує максимальну кількість символів (включно з нульовим символом у кінці), які потрібно записати в буфер.
- Функція snprintf() використовується для перенаправлення виводу функції printf() у буфер.
- Функція snprintf() також повертає кількість символів, які мали бути записані в буфер (за винятком нульового термінатора), незалежно від переданого значення «n».
- Таким чином, лише якщо повернуте значення є невід’ємним і менше ніж «n», рядок було повністю записано, як очікувалося.
Синтаксис: Синтаксис методу snprintf() такий:
int snprintf(char *str, size_t size, const char *format, …);
Параметри:
- *str: це буфер. size : максимальна кількість байтів (символів), яка буде записана в буфер. format : рядок C, який містить рядок формату, який відповідає тим самим специфікаціям, що й format у printf … : необов’язкові (…) аргументи це лише формати рядків, як-от (%d, myint), як показано у printf.
Повернене значення:
- Кількість символів, які були б записані в буфер, якби «n» було достатньо великим. Кінцевий нульовий символ не враховується.
- Якщо виникає помилка кодування, повертається від’ємне число.
Нижче наведено приклад для ілюстрації роботи методу snprintf():
Приклад 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;> }> |
Вихід
Writing geeksforgeeks onto buffer with capacity 6 String written on buffer = geeks Value returned by snprintf() method = 14
приклад 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;> }> |
Вихід
The number of bytes printed to 'buffer' (excluding the null terminator) is 45 Joined string: The quick brown fox jumped over the lazy dog.
