WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

memmove — überlappungssichere C23-Bytekopie

`memmove(s1, s2, n)` aus `<string.h>` kopiert `n` Darstellungsbytes von der Quelle in das beschreibbare Ziel und liefert das ursprüngliche `s1`. Anders als bei `memcpy` ist das Ergebnis auch bei überlappenden Bereichen definiert: semantisch werden die Quellbytes zuerst in ein getrenntes temporäres Array aus `n` Bytes kopiert.

Version: C23

Syntax

void *memmove(void *s1, const void *s2, size_t n);

memmove(s1, s2, n) aus <string.h> kopiert n Darstellungsbytes von der Quelle in das beschreibbare Ziel und liefert das ursprüngliche s1. Anders als bei memcpy ist das Ergebnis auch bei überlappenden Bereichen definiert: semantisch werden die Quellbytes zuerst in ein getrenntes temporäres Array aus n Bytes kopiert.

Das Beispiel verschiebt die ersten vier Bytes von "ABCDE" im selben Puffer um eine Stelle nach rechts. Die Bereiche überlappen absichtlich; Ausgabe 1 AABCD bestätigt sowohl den Rückgabezeiger text + 1 als auch den Erhalt der ursprünglichen Bytes trotz Überschreiben nach vorne.

Überlappungssicherheit korrigiert keine falschen Grenzen: Beide n-Byte-Bereiche müssen in zugängliche Objekte passen, das Ziel muss beschreibbar sein und die Zeigerwerte bleiben selbst bei n == 0 erforderlich. Die Funktion kopiert Bytes, nicht Elemente oder Ressourcenbesitz, und fügt kein \0 an; beim Verschieben eines Stringteils den Terminator ausdrücklich mitnehmen, wenn er zum Ergebnis gehört.

Beispiele

#include <stdio.h>
#include <string.h>
int main(void){char text[]="ABCDE";void *result=memmove(text+1,text,4);printf("%d %s\n",result==text+1,text);return 0;}

Ergebnis

1 AABCD

Das Beispiel verschiebt die ersten vier Bytes von `"ABCDE"` im selben Puffer um eine Stelle nach rechts. Die Bereiche überlappen absichtlich; Ausgabe `1 AABCD` bestätigt sowohl den Rückgabezeiger `text + 1` als auch den Erhalt der ursprünglichen Bytes trotz Überschreiben nach vorne.

Quellen