CKTIS / C
snprintf — formato con límite de búfer
snprintf escribe texto con formato en un búfer de capacidad especificada. Su valor de retorno permite detectar el truncamiento; la capacidad incluye el carácter nulo final.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdio.h>
int snprintf(char * restrict s, size_t n, const char * restrict format, ...);snprintf de <stdio.h> da formato a los datos en el array s. Para n > 0, escribe como máximo n - 1 caracteres y el \0 final. Indica la capacidad disponible real del búfer, no el tamaño del puntero.
Comprueba primero result < 0: un valor de retorno negativo indica un error de codificación. En caso contrario, el valor de retorno es la longitud necesaria sin contar \0, y (unsigned int)result >= n indica que no hay espacio suficiente para el resultado completo, incluido \0. Todo valor no negativo de tipo int se puede representar en unsigned int, y las conversiones implícitas de esta comparación conservan ambos valores. En cambio, convertir el valor de retorno a size_t puede alterar un valor mayor que SIZE_MAX y ocultar el truncamiento.
snprintf(NULL, 0, ...) no escribe nada y permite calcular la longitud. Los tipos de los argumentos deben coincidir con el formato; copiar entre objetos solapados tiene un comportamiento indefinido.
Ejemplos
#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;
}
Resultado
buffer: abcd required: 6 truncated
El código y la salida indicada se verificaron en un entorno aislado. La conversión a `size_t` funciona aquí porque el valor devuelto, `6`, se puede representar en ese tipo. En general, usa la comparación con `unsigned int` descrita arriba.