Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes