CKTIS / C
memcpy — copie C23 d’octets sans chevauchement
`memcpy(s1, s2, n)` de `<string.h>` copie exactement `n` octets de représentation d’objet depuis la source `s2` vers la destination modifiable `s1`, puis renvoie la valeur initiale de `s1`. Les octets sont traités comme `unsigned char` ; la fonction ignore éléments, longueurs de tableaux et terminateurs de texte.
Version : C23
Syntaxe
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) de <string.h> copie exactement n octets de représentation d’objet depuis la source s2 vers la destination modifiable s1, puis renvoie la valeur initiale de s1. Les octets sont traités comme unsigned char ; la fonction ignore éléments, longueurs de tableaux et terminateurs de texte.
L’exemple copie la représentation complète d’un tableau de quatre int dans un tableau distinct. La sortie 1 5 13 confirme l’identité du pointeur renvoyé et les valeurs réellement copiées aux indices 1 et 3.
Les zones source et cible ne doivent se chevaucher même partiellement : cette copie a un comportement indéfini ; emploie memmove si elles peuvent se recouvrir. Les deux pointeurs doivent être valides même pour n == 0 et, si n est positif, toute la cible doit être inscriptible et les deux plages rester dans leurs objets. memcpy est superficiel : les pointeurs copiés visent les mêmes ressources, aucun \0 n’est ajouté et count * sizeof *p exige un contrôle de débordement.
Exemples
#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;}
Résultat
1 5 13
L’exemple copie la représentation complète d’un tableau de quatre `int` dans un tableau distinct. La sortie `1 5 13` confirme l’identité du pointeur renvoyé et les valeurs réellement copiées aux indices 1 et 3.