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

CKTIS / C

vsprintf — форматиране в буфер с va_list

vsprintf записва форматиран текст в буфер, като получава аргументите от va_list. Не получава размера на буфера.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <stdarg.h>
#include <stdio.h>
int vsprintf(char * restrict s, const char * restrict format, va_list arg);

vsprintf работи като sprintf, но приема va_list вместо аргументи .... Освен това записва в s завършващ нулев символ.

Буферът трябва да побира целия резултат заедно с нулевия символ. Препълването и копирането между припокриващи се обекти водят до неопределено поведение. Типовете на аргументите трябва да съответстват на спецификаторите във формата. Не използвайте ненадежден текст като format; изберете vsnprintf, за да ограничите записването.

Инициализирайте списъка с va_start. Функцията не извиква va_end: направете го сами. Не четете списъка повторно след извикването. За независимо обхождане предварително подгответе копие с va_copy.

Върнатата стойност показва броя на записаните символи без завършващия нулев символ или е отрицателна при грешка в кодирането.

Примери

#include <stdarg.h>
#include <stdio.h>

/* Only for calls whose complete output fits in dst. */
static int format_text(char *dst, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vsprintf(dst, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    char text[16];
    int count = format_text(text, "score=%d", 7);
    if (count < 0) {
        return 1;
    }
    puts(text);
    printf("%d\n", count);
    return 0;
}

Резултат

score=7
7

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

Източници