Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

vsnprintf — formatiranje va_list u ograničeni međuspremnik

vsnprintf formatira argumente predane putem va_list. Ograničava zapis na kapacitet međuspremnika, a vraćena duljina omogućuje otkrivanje skraćenog izlaza.

Verzija: 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 radi kao snprintf, ali prihvaća va_list umjesto argumenata .... Koristi se za izradu vlastitih funkcija za formatiranje.

n je kapacitet međuspremnika u bajtovima, uključujući završni \0. Za n > 0 zapisuje najviše n - 1 bajtova izlaza i završni znak. Za n == 0 ne zapisuje ništa; s može biti NULL.

Rezultat r predstavlja potrebnu duljinu bez završnog znaka; negativna vrijednost označava pogrešku kodiranja. Najprije provjerite r < 0. Ako je r nenegativan i vrijedi n > 0, uvjet (unsigned int)r >= n znači da je izlaz skraćen. Pretvorba u unsigned int čuva svaku nenegativnu vrijednost tipa int, čak i ako je size_t ne može prikazati.

Popis inicijalizirajte pomoću va_start i završite pomoću va_end; funkcija ne obavlja ovo drugo. Za sljedeći prolaz upotrijebite va_copy prije nego što potrošite popis i završite i kopiju. Vrste argumenata moraju odgovarati formatu; preklapajući kopirani objekti uzrokuju nedefinirano ponašanje. Nepouzdan tekst predajte kao podatak za %s, a ne kao format.

Primjeri

#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

Nakon provjere je li `result` negativan, primjer pretvara nenegativnu vrijednost u `unsigned int` i uspoređuje je s kapacitetom međuspremnika. Potrebno je 10 bajtova bez završnog znaka, pa se u međuspremnik kapaciteta 8 bajtova zapisuje samo `item:12` sa završnim znakom.

Izvori