KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

vsprintf — formatteren naar een buffer met va_list

vsprintf schrijft opgemaakte tekst naar een buffer en haalt de argumenten uit een va_list. De functie krijgt geen bufferlengte mee.

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

Syntax

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

vsprintf werkt als sprintf, maar accepteert een va_list in plaats van argumenten .... De functie schrijft ook een afsluitend nulteken naar s.

De buffer moet ruimte bieden aan het volledige resultaat en het nulteken. Een bufferoverschrijding en kopiëren tussen overlappende objecten leiden tot ongedefinieerd gedrag. De argumenttypen moeten overeenkomen met de formaatspecificaties. Gebruik geen onbetrouwbare tekst als format; kies vsnprintf om schrijfacties te begrenzen.

Initialiseer de lijst met va_start. De functie roept va_end niet aan: doe dat zelf. Lees de lijst na de aanroep niet opnieuw uit. Maak vooraf met va_copy een kopie als je de lijst onafhankelijk wilt doorlopen.

De retourwaarde geeft het aantal geschreven tekens exclusief het afsluitende nulteken aan, of is negatief bij een coderingsfout.

Voorbeelden

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

Resultaat

score=7
7

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen