CKTIS / C
strcpy — copiar uma cadeia de caracteres
strcpy copia uma cadeia de caracteres, incluindo o seu '\0' terminador. Quem chama tem de fornecer espaço suficiente no destino e garantir que os objetos não se sobrepõem.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <string.h>
char *strcpy(char * restrict s1, const char * restrict s2);strcpy, declarada em <string.h>, copia a cadeia de caracteres de s2 para s1, incluindo o '\0' terminador. Devolve s1, não o número de caracteres copiados.
A origem tem de conter uma cadeia de caracteres válida terminada em nulo. O destino tem de ser gravável e ter capacidade para, pelo menos, strlen(s2) + 1 bytes. A função não recebe o tamanho do buffer nem aloca memória. Um buffer demasiado pequeno ou a sobreposição dos objetos copiados provoca comportamento indefinido; não espere um código de erro.
No exemplo, sizeof source inclui o terminador nulo, pelo que destination tem tamanho suficiente. Os arrays separados não se sobrepõem. puts escreve a cópia e acrescenta uma mudança de linha.
Exemplos
#include <stdio.h>
#include <string.h>
int main(void)
{
const char source[] = "Hello";
char destination[sizeof source];
strcpy(destination, source);
puts(destination);
return 0;
}
Resultado
Hello
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.