Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje