Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

vsnprintf — oblikovanje va_list v omejen medpomnilnik

vsnprintf oblikuje argumente, podane prek va_list. Zapis omeji na zmogljivost medpomnilnika, vrnjena dolžina pa omogoča zaznati skrajšan izpis.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

vsnprintf deluje kot snprintf, vendar namesto argumentov ... sprejme va_list. Uporablja se za izdelavo lastnih funkcij za oblikovanje.

n je zmogljivost medpomnilnika v bajtih, vključno s končnim \0. Pri n > 0 zapiše največ n - 1 bajtov izpisa in zaključni znak. Pri n == 0 ne zapiše ničesar; s je lahko NULL.

Rezultat r je potrebna dolžina brez zaključnega znaka; negativna vrednost pomeni napako pri kodiranju. Najprej preverite r < 0. Če je r nenegativen in velja n > 0, pogoj (unsigned int)r >= n pomeni, da je izpis skrajšan. Pretvorba v unsigned int ohrani vsako nenegativno vrednost tipa int, tudi če je s tipom size_t ni mogoče predstaviti.

Seznam inicializirajte z va_start in ga zaključite z va_end; funkcija tega ne stori namesto vas. Za nov prehod uporabite va_copy, preden seznam porabite, in zaključite tudi kopijo. Vrste argumentov se morajo ujemati z obliko; prekrivajoči se kopirani objekti povzročijo nedefinirano vedenje. Nezaupanja vredno besedilo podajte kot podatek za %s, ne kot obliko.

Primeri

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

Rezultat

text=item:12
needed=10
truncated=1

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri