Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła