Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

snprintf — formattazione con limite del buffer

snprintf scrive testo formattato in un buffer con capacità specificata. Il valore restituito permette di rilevare il troncamento; la capacità include il carattere nullo finale.

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

Sintassi

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

snprintf di <stdio.h> formatta i dati nell’array s. Per n > 0, scrive al massimo n - 1 caratteri più il \0 finale. Indica la capacità effettivamente disponibile del buffer, non la dimensione del puntatore.

Controlla prima result < 0: un valore restituito negativo indica un errore di codifica. Altrimenti, il valore restituito è la lunghezza richiesta, escluso \0, e (unsigned int)result >= n indica che non c’è spazio sufficiente per il risultato completo, incluso \0. Ogni valore non negativo di tipo int è rappresentabile come unsigned int e le conversioni implicite di questo confronto preservano entrambi i valori. Convertire invece il valore restituito in size_t può alterare un valore maggiore di SIZE_MAX e nascondere il troncamento.

snprintf(NULL, 0, ...) non scrive nulla e consente di calcolare la lunghezza. I tipi degli argomenti devono corrispondere al formato; copiare tra oggetti sovrapposti ha comportamento indefinito.

Esempi

#include <stdio.h>

int main(void)
{
    char buf[5];
    int result = snprintf(buf, sizeof buf, "%s", "abcdef");

    if (result < 0) {
        puts("encoding error");
        return 1;
    }
    printf("buffer: %s\nrequired: %d\n", buf, result);
    if ((size_t)result >= sizeof buf) {
        puts("truncated");
    }
    return 0;
}

Risultato

buffer: abcd
required: 6
truncated

Il codice e l’output indicato sono stati verificati in un ambiente isolato. La conversione in `size_t` funziona qui perché il valore restituito, `6`, è rappresentabile in quel tipo. In generale, usa il confronto con `unsigned int` descritto sopra.

Fonti