CKTIS / C
strcat — acrescentar uma cadeia
strcat, de <string.h>, acrescenta uma cadeia de origem a uma cadeia de destino. Exige um buffer suficientemente grande e não verifica a sua capacidade.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <string.h>
char *strcat(char * restrict s1, const char * restrict s2);strcat(s1, s2) substitui o \0 final de s1 por uma cópia de s2, incluindo o respetivo \0. Devolve s1, e não um ponteiro para o fim do resultado.
Ambos os argumentos têm de apontar para cadeias válidas terminadas em nulo. O buffer de destino tem de ser gravável e comportar, pelo menos, strlen(s1) + strlen(s2) + 1 bytes. A sobreposição dos objetos envolvidos na cópia provoca comportamento indefinido.
A função não recebe a capacidade do buffer nem oferece proteção contra overflow. Um buffer demasiado pequeno provoca comportamento indefinido, não um truncamento seguro. Acrescentar repetidamente pode ser ineficiente: cada chamada volta a procurar o fim da cadeia de destino.
Exemplos
#include <stdio.h>
#include <string.h>
int main(void)
{
char text[12] = "Hello";
const char suffix[] = ", C!";
strcat(text, suffix);
puts(text);
return 0;
}
Resultado
Hello, C!
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.