CKTIS / C
vsnprintf — форматиране на va_list в буфер с ограничен капацитет
vsnprintf форматира аргументи, подадени чрез va_list. Ограничава записването до капацитета на буфера, а върнатата дължина позволява да се открие съкратен изход.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <stdarg.h>
#include <stdio.h>
int vsnprintf(char * restrict s, size_t n, const char * restrict format, va_list arg);vsnprintf работи като snprintf, но приема va_list вместо аргументи .... Използва се за създаване на собствени функции за форматиране.
n е капацитетът на буфера в байтове, включително крайния \0. При n > 0 функцията записва най-много n - 1 байта изход и завършващ знак. При n == 0 не записва нищо; s може да бъде NULL.
Резултатът r е необходимата дължина без завършващия знак; отрицателна стойност показва грешка при кодирането. Първо проверете r < 0. Ако r е неотрицателно и n > 0, условието (unsigned int)r >= n означава, че изходът е съкратен. Преобразуването към unsigned int запазва всяка неотрицателна стойност от тип int, дори когато size_t не може да я представи.
Инициализирайте списъка с va_start и го приключете с va_end; функцията не извършва последното вместо вас. За повторно обхождане копирайте списъка с va_copy, преди да започнете да извличате аргументи от него, и извикайте va_end и за копието. Типовете на аргументите трябва да съответстват на формата; припокриващи се копирани обекти водят до неопределено поведение. Подайте недоверения текст като данни за %s, а не като формат.
Примери
#include <stdarg.h>
#include <stdio.h>
static int format_to(char *dst, size_t cap, const char *fmt, ...)
{
va_list args;
va_start(args, fmt);
int result = vsnprintf(dst, cap, fmt, args);
va_end(args);
return result;
}
int main(void)
{
char buf[8];
int result = format_to(buf, sizeof buf, "%s:%d", "item", 12345);
if (result < 0) {
return 1;
}
printf("text=%s\nneeded=%d\ntruncated=%d\n",
buf, result, (unsigned int)result >= sizeof buf);
return 0;
}Резултат
text=item:12 needed=10 truncated=1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.