CKTIS / C
snprintf — форматиране с ограничен буфер
snprintf записва форматиран текст в буфер със зададен капацитет. Стойността на връщане позволява да се установи съкращаване; капацитетът включва крайния нулев знак.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <stdio.h>
int snprintf(char * restrict s, size_t n, const char * restrict format, ...);snprintf от <stdio.h> форматира данни в масива s. При n > 0 записва най-много n - 1 знака и крайния \0. Посочете действително наличния капацитет на буфера, а не размера на указателя.
Първо проверете result < 0: отрицателна върната стойност означава грешка при кодирането. В противен случай върнатата стойност е необходимата дължина без \0, а (unsigned int)result >= n означава, че няма достатъчно място за пълния резултат заедно с \0. Всяка неотрицателна стойност от тип int може да се представи в unsigned int, а неявните преобразувания при това сравнение запазват и двете стойности. Преобразуването на върнатата стойност в size_t обаче може да промени стойност, по-голяма от SIZE_MAX, и така да прикрие съкращаването.
snprintf(NULL, 0, ...) не записва нищо и позволява изчисляване на дължината. Типовете на аргументите трябва да съответстват на формата; копирането между припокриващи се обекти води до недефинирано поведение.
Примери
#include <stdio.h>
int main(void)
{
char buf[5];
int result = snprintf(buf, sizeof buf, "%s", "abcdef");
if (result < 0) {
puts("encoding error");
return 1;
}
printf("buffer: %s\nrequired: %d\n", buf, result);
if ((size_t)result >= sizeof buf) {
puts("truncated");
}
return 0;
}
Резултат
buffer: abcd required: 6 truncated
Кодът и посоченият изход са проверени в изолирана среда. Преобразуването в `size_t` работи в този пример, защото върнатата стойност `6` може да се представи в този тип. В общия случай използвайте описаното по-горе сравнение с `unsigned int`.