Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

vsprintf — formátování do bufferu pomocí va_list

vsprintf zapisuje formátovaný text do bufferu a argumenty získává z va_list. Velikost bufferu nepřijímá.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

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

vsprintf funguje jako sprintf, ale místo argumentů ... přijímá va_list. Do s zapisuje také ukončovací nulový znak.

Buffer musí pojmout celý výsledek včetně nulového znaku. Přetečení a kopírování mezi překrývajícími se objekty způsobují nedefinované chování. Typy argumentů musí odpovídat specifikátorům formátu. Nedůvěryhodný text nepoužívejte jako format; pro omezení zápisu zvolte vsnprintf.

Seznam inicializujte pomocí va_start. Funkce va_end nevolá: zavolejte jej sami. Po volání seznam znovu nečtěte. Pokud jej chcete samostatně projít, připravte si předem kopii pomocí va_copy.

Návratová hodnota udává počet zapsaných znaků bez ukončovacího nulového znaku, nebo je při chybě kódování záporná.

Příklady

#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;
}

Výsledek

score=7
7

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje