CKTIS / C
memcpy — copia C23 di byte non sovrapposti
`memcpy(s1, s2, n)` di `<string.h>` copia esattamente `n` byte di rappresentazione dell’oggetto dalla sorgente `s2` alla destinazione modificabile `s1` e restituisce il valore originale di `s1`. I byte sono interpretati come `unsigned char`; la funzione non conosce elementi, lunghezze di array o terminatori di testo.
Versione: C23
Sintassi
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) di <string.h> copia esattamente n byte di rappresentazione dell’oggetto dalla sorgente s2 alla destinazione modificabile s1 e restituisce il valore originale di s1. I byte sono interpretati come unsigned char; la funzione non conosce elementi, lunghezze di array o terminatori di testo.
L’esempio copia la rappresentazione completa di un array di quattro int in un array separato. L’output 1 5 13 conferma l’identità del puntatore restituito e i valori realmente copiati negli elementi agli indici 1 e 3.
Le regioni sorgente e destinazione non devono sovrapporsi neppure in parte: tale copia ha comportamento indefinito; usa memmove se possono sovrapporsi. Entrambi i puntatori devono essere validi anche con n == 0 e, con n positivo, l’intera destinazione deve essere scrivibile e gli intervalli rientrare negli oggetti. memcpy è superficiale: i puntatori copiati indicano le stesse risorse, non aggiunge \0 e count * sizeof *p richiede controllo dell’overflow.
Esempi
#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;}
Risultato
1 5 13
L’esempio copia la rappresentazione completa di un array di quattro `int` in un array separato. L’output `1 5 13` conferma l’identità del puntatore restituito e i valori realmente copiati negli elementi agli indici 1 e 3.