WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

memcpy — C23-Bytekopie ohne Überlappung

`memcpy(s1, s2, n)` aus `<string.h>` kopiert genau `n` Bytes einer Objektdarstellung von Quelle `s2` in das beschreibbare Ziel `s1` und liefert den ursprünglichen Wert von `s1`. Die Bytes werden wie `unsigned char` interpretiert; die Funktion kennt weder Elemente noch Arraylängen oder Textterminatoren.

Version: C23

Syntax

void *memcpy(void * restrict s1, const void * restrict s2, size_t n);

memcpy(s1, s2, n) aus <string.h> kopiert genau n Bytes einer Objektdarstellung von Quelle s2 in das beschreibbare Ziel s1 und liefert den ursprünglichen Wert von s1. Die Bytes werden wie unsigned char interpretiert; die Funktion kennt weder Elemente noch Arraylängen oder Textterminatoren.

Das Beispiel kopiert die vollständige Darstellung eines int-Arrays mit vier Elementen in ein getrenntes Array. Ausgabe 1 5 13 bestätigt die Identität des Rückgabezeigers und die tatsächlich in die Elemente 1 und 3 kopierten Werte.

Quell- und Zielbereich dürfen sich nicht einmal teilweise überlappen — eine solche Kopie hat undefiniertes Verhalten; bei möglicher Überlappung memmove verwenden. Beide Zeigerwerte müssen auch bei n == 0 gültig sein, und bei positivem n muss das ganze Ziel beschreibbar sein und beide Bereiche in ihre Objekte passen. memcpy kopiert flach: kopierte Zeiger bezeichnen dieselben Ressourcen, es wird kein \0 angefügt und count * sizeof *p benötigt eine Überlaufprüfung.

Beispiele

#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;}

Ergebnis

1 5 13

Das Beispiel kopiert die vollständige Darstellung eines `int`-Arrays mit vier Elementen in ein getrenntes Array. Ausgabe `1 5 13` bestätigt die Identität des Rückgabezeigers und die tatsächlich in die Elemente 1 und 3 kopierten Werte.

Quellen