CKTIS / C
memcpy — kopírovanie neprekrývajúcich sa bajtov C23
`memcpy(s1, s2, n)` z `<string.h>` skopíruje presne `n` bajtov reprezentácie objektu zo zdroja `s2` do zapisovateľného cieľa `s1` a vráti pôvodnú hodnotu `s1`. Bajty sa vykladajú ako `unsigned char`; funkcia nepozná prvky, dĺžky polí ani ukončovacie znaky textu.
Verzia: C23
Syntax
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) z <string.h> skopíruje presne n bajtov reprezentácie objektu zo zdroja s2 do zapisovateľného cieľa s1 a vráti pôvodnú hodnotu s1. Bajty sa vykladajú ako unsigned char; funkcia nepozná prvky, dĺžky polí ani ukončovacie znaky textu.
Príklad skopíruje úplnú reprezentáciu štvorprvkového poľa int do oddeleného poľa. Výstup 1 5 13 potvrdzuje totožnosť vráteného ukazovateľa a hodnoty skutočne skopírované do prvkov s indexmi 1 a 3.
Zdrojová a cieľová oblasť sa nesmú ani čiastočne prekrývať — také kopírovanie má nedefinované správanie; pri možnom prekrytí použite memmove. Oba ukazovatele musia byť platné aj pri n == 0; pre kladné n musí byť celý cieľ zapisovateľný a oba rozsahy v objektoch. memcpy je plytké: skopírované ukazovatele mieria na rovnaké prostriedky, nepridáva \0 a count * sizeof *p vyžaduje kontrolu pretečenia.
Prí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ýsledok
1 5 13
Príklad skopíruje úplnú reprezentáciu štvorprvkového poľa `int` do oddeleného poľa. Výstup `1 5 13` potvrdzuje totožnosť vráteného ukazovateľa a hodnoty skutočne skopírované do prvkov s indexmi 1 a 3.