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.