CKTIS / C
strncat — concatenar com um limite de bytes da origem
strncat acrescenta, no máximo, n bytes da origem a uma cadeia e adiciona '\0'. O parâmetro n não representa a capacidade do buffer de destino.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat, de <string.h>, acrescenta, no máximo, n bytes de s2 a s1, parando mais cedo se encontrar '\0'. Substitui o terminador existente e acrescenta um novo. Devolve s1, não um comprimento nem uma indicação de truncagem.
s1 tem de apontar para uma cadeia modificável terminada em nulo. A origem tem de disponibilizar n bytes legíveis ou um terminador anterior. A falta de espaço ou a sobreposição de regiões durante a cópia provoca comportamento indefinido.
n limita os dados da origem, não o tamanho do resultado. Não verifiques a capacidade calculando strlen(s1) + n + 1 sem controlar o transbordo: na aritmética sem sinal, um transbordo pode produzir um valor demasiado pequeno. Se capacity for a capacidade do buffer de destino em bytes e strlen(s1) < capacity, então n <= capacity - strlen(s1) - 1 garante espaço para acrescentar até n bytes e o novo terminador. Para um array dst corretamente terminado, calcula o espaço restante como sizeof dst - strlen(dst) - 1; não uses esta fórmula com sizeof de um apontador. Com n == 0, a cadeia permanece inalterada, mas os apontadores têm de continuar válidos.
Exemplos
#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!
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.