Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

vsnprintf — formátovanie va_list do obmedzeného buffera

vsnprintf formátuje argumenty odovzdané prostredníctvom va_list. Obmedzuje zápis podľa kapacity buffera a vrátená dĺžka umožňuje zistiť skrátenie výstupu.

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

Syntax

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

vsnprintf funguje ako snprintf, ale namiesto argumentov ... prijíma va_list. Používa sa na vytváranie vlastných formátovacích funkcií.

n je kapacita buffera v bajtoch vrátane záverečného \0. Pre n > 0 zapíše najviac n - 1 bajtov výstupu a ukončovací znak. Pre n == 0 nezapíše nič; s môže byť NULL.

Výsledok r je potrebná dĺžka bez ukončovacieho znaku; záporná hodnota označuje chybu kódovania. Najprv skontrolujte r < 0. Ak je r nezáporné a platí n > 0, podmienka (unsigned int)r >= n znamená, že výstup bol skrátený. Konverzia na unsigned int zachová každú nezápornú hodnotu typu int, aj keď ju typ size_t nedokáže reprezentovať.

Zoznam inicializujte pomocou va_start a ukončite pomocou va_end; funkcia druhý krok nevykonáva. Pri ďalšom prechode použite va_copy pred spotrebovaním zoznamu a ukončite aj kópiu. Typy argumentov musia zodpovedať formátu; prekrývajúce sa kopírované objekty spôsobujú nedefinované správanie. Nedôveryhodný text odovzdávajte ako údaje pre %s, nie ako formát.

Príklady

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

Výsledok

text=item:12
needed=10
truncated=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje