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

CKTIS / C

memcpy — cópia C23 de bytes sem sobreposição

`memcpy(s1, s2, n)` de `<string.h>` copia exatamente `n` bytes da representação de objeto da origem `s2` para o destino modificável `s1` e devolve o valor original de `s1`. Os bytes são interpretados como `unsigned char`; a função não conhece elementos, comprimentos de arrays nem terminadores de texto.

Versão: C23

Sintaxe

void *memcpy(void * restrict s1, const void * restrict s2, size_t n);

memcpy(s1, s2, n) de <string.h> copia exatamente n bytes da representação de objeto da origem s2 para o destino modificável s1 e devolve o valor original de s1. Os bytes são interpretados como unsigned char; a função não conhece elementos, comprimentos de arrays nem terminadores de texto.

O exemplo copia a representação completa de um array de quatro int para um array separado. A saída 1 5 13 confirma a identidade do ponteiro devolvido e os valores realmente copiados para os elementos de índices 1 e 3.

As regiões de origem e destino não podem sobrepor-se nem parcialmente — essa cópia tem comportamento indefinido; usa memmove se puderem sobrepor-se. Ambos os ponteiros têm de ser válidos mesmo com n == 0 e, com n positivo, todo o destino tem de ser gravável e os dois intervalos caber nos objetos. memcpy é superficial: ponteiros copiados designam os mesmos recursos, não acrescenta \0 e count * sizeof *p requer verificação de overflow.

Exemplos

#include <stdio.h>
#include <string.h>
int main(void){const int source[]={3,5,8,13};int target[4]={0};void *result=memcpy(target,source,sizeof source);printf("%d %d %d\n",result==target,target[1],target[3]);return 0;}

Resultado

1 5 13

O exemplo copia a representação completa de um array de quatro `int` para um array separado. A saída `1 5 13` confirma a identidade do ponteiro devolvido e os valores realmente copiados para os elementos de índices 1 e 3.

Fontes