CKTIS / C
memcpy — C23-bytekopie zonder overlap
`memcpy(s1, s2, n)` uit `<string.h>` kopieert exact `n` bytes objectrepresentatie van bron `s2` naar schrijfbaar doel `s1` en retourneert de oorspronkelijke waarde van `s1`. De bytes worden als `unsigned char` geïnterpreteerd; de functie kent geen elementen, arraylengten of tekstafsluiters.
Versie: C23
Syntax
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) uit <string.h> kopieert exact n bytes objectrepresentatie van bron s2 naar schrijfbaar doel s1 en retourneert de oorspronkelijke waarde van s1. De bytes worden als unsigned char geïnterpreteerd; de functie kent geen elementen, arraylengten of tekstafsluiters.
Het voorbeeld kopieert de volledige representatie van een int-array met vier elementen naar een afzonderlijke array. Uitvoer 1 5 13 bevestigt de identiteit van de geretourneerde pointer en de werkelijk gekopieerde waarden op indices 1 en 3.
Bron- en doelgebied mogen zelfs niet gedeeltelijk overlappen — zo’n kopie heeft ongedefinieerd gedrag; gebruik memmove als overlap mogelijk is. Beide pointerwaarden moeten ook bij n == 0 geldig zijn, en bij positieve n moet het hele doel schrijfbaar zijn en moeten beide bereiken in hun objecten passen. memcpy is oppervlakkig: gekopieerde pointers wijzen naar dezelfde bronnen, er wordt geen \0 toegevoegd en count * sizeof *p vereist overflowcontrole.
Voorbeelden
#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;}
Resultaat
1 5 13
Het voorbeeld kopieert de volledige representatie van een `int`-array met vier elementen naar een afzonderlijke array. Uitvoer `1 5 13` bevestigt de identiteit van de geretourneerde pointer en de werkelijk gekopieerde waarden op indices 1 en 3.