CKTIS / C
memcpy — kopiowanie niepokrywających się bajtów C23
`memcpy(s1, s2, n)` z `<string.h>` kopiuje dokładnie `n` bajtów reprezentacji obiektu ze źródła `s2` do modyfikowalnego celu `s1` i zwraca pierwotną wartość `s1`. Bajty są interpretowane jak `unsigned char`; funkcja nie zna elementów, długości tablic ani końca tekstu.
Wersja: C23
Składnia
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) z <string.h> kopiuje dokładnie n bajtów reprezentacji obiektu ze źródła s2 do modyfikowalnego celu s1 i zwraca pierwotną wartość s1. Bajty są interpretowane jak unsigned char; funkcja nie zna elementów, długości tablic ani końca tekstu.
Przykład kopiuje pełną reprezentację czteroelementowej tablicy int do oddzielnej tablicy. Wynik 1 5 13 potwierdza tożsamość zwróconego wskaźnika oraz rzeczywiście skopiowane elementy o indeksach 1 i 3.
Obszary źródłowy i docelowy nie mogą nakładać się nawet częściowo — takie kopiowanie ma zachowanie niezdefiniowane; użyj wtedy memmove. Oba wskaźniki muszą być poprawne nawet dla n == 0, a dla dodatniego n cały zakres celu musi być zapisywalny i oba zakresy mieścić się w obiektach. memcpy wykonuje kopię płytką: skopiowane wskaźniki nadal wskazują te same zasoby, nie dodaje \0, a rozmiar liczony jako count * sizeof *p wymaga kontroli przepełnienia.
Przykłady
#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;}
Wynik
1 5 13
Przykład kopiuje pełną reprezentację czteroelementowej tablicy `int` do oddzielnej tablicy. Wynik `1 5 13` potwierdza tożsamość zwróconego wskaźnika oraz rzeczywiście skopiowane elementy o indeksach 1 i 3.