CKTIS / C
memcpy — kopie nepřekrývajících se bajtů C23
`memcpy(s1, s2, n)` z `<string.h>` zkopíruje přesně `n` bajtů reprezentace objektu ze zdroje `s2` do zapisovatelného cíle `s1` a vrátí původní hodnotu `s1`. Bajty se vykládají jako `unsigned char`; funkce nezná prvky, délky polí ani ukončovací znaky textu.
Verze: C23
Syntaxe
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) z <string.h> zkopíruje přesně n bajtů reprezentace objektu ze zdroje s2 do zapisovatelného cíle s1 a vrátí původní hodnotu s1. Bajty se vykládají jako unsigned char; funkce nezná prvky, délky polí ani ukončovací znaky textu.
Příklad zkopíruje úplnou reprezentaci čtyřprvkového pole int do odděleného pole. Výstup 1 5 13 potvrzuje totožnost vráceného ukazatele a hodnoty skutečně zkopírované do prvků s indexy 1 a 3.
Zdrojová a cílová oblast se nesmějí ani částečně překrývat — takové kopírování má nedefinované chování; při možném překrytí použijte memmove. Oba ukazatele musí být platné i při n == 0; pro kladné n musí být celý cíl zapisovatelný a oba rozsahy v objektech. memcpy je mělké: zkopírované ukazatele míří na stejné prostředky, nepřidává \0 a count * sizeof *p vyžaduje kontrolu přetečení.
Příklady
#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;}
Výsledek
1 5 13
Příklad zkopíruje úplnou reprezentaci čtyřprvkového pole `int` do odděleného pole. Výstup `1 5 13` potvrzuje totožnost vráceného ukazatele a hodnoty skutečně zkopírované do prvků s indexy 1 a 3.