Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes