Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje