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.