База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници