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

CKTIS / C

strncat — concatenar con un límite de bytes de origen

strncat añade como máximo n bytes de origen a una cadena y agrega '\0'. El parámetro n no representa la capacidad del búfer de destino.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);

strncat, de <string.h>, añade como máximo n bytes de s2 a s1 y se detiene antes si encuentra '\0'. Sobrescribe el terminador existente y añade uno nuevo. Devuelve s1, no una longitud ni información sobre un posible truncamiento.

s1 debe apuntar a una cadena modificable terminada en nulo. El origen debe proporcionar n bytes legibles o un terminador anterior. Si no hay espacio suficiente o las regiones se solapan durante la copia, el comportamiento no está definido.

n limita los datos de origen, no el tamaño del resultado. No compruebes la capacidad calculando strlen(s1) + n + 1 sin controlar el desbordamiento: un desbordamiento en la aritmética sin signo puede dar un valor demasiado pequeño. Si capacity es la capacidad del búfer de destino en bytes y strlen(s1) < capacity, entonces n <= capacity - strlen(s1) - 1 garantiza espacio para añadir hasta n bytes y el nuevo terminador. Para un arreglo dst correctamente terminado, calcula el espacio restante como sizeof dst - strlen(dst) - 1; no uses esta fórmula con sizeof de un puntero. Con n == 0, la cadena no cambia, pero los punteros deben seguir siendo válidos.

Ejemplos

#include <stdio.h>
#include <string.h>

int main(void)
{
    char dst[10] = "Hi ";
    const char src[] = "there!";
    size_t room = sizeof dst - strlen(dst) - 1;

    strncat(dst, src, room);
    puts(dst);
    return 0;
}

Resultado

Hi there!

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes