CKTIS / C++
std::memcpy — Speicherbytes kopieren
std::memcpy aus <cstring> kopiert eine angegebene Anzahl von Bytes zwischen nicht überlappenden Speicherbereichen. Die Funktion prüft keine Grenzen und ersetzt nicht das Kopieren von Objekten, die Ressourcen verwalten.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstring>
void* std::memcpy(void* dest, const void* src, std::size_t count);std::memcpy(dest, src, count) aus <cstring> kopiert count Bytes von src nach dest, nicht count Elemente. Die Funktion hält nicht bei einem Nullbyte an. Sie gibt einen Zeiger auf ein geeignetes implizit erzeugtes Objekt zurück oder, falls es keines gibt, den Wert von dest.
Die Quelle muss die erforderliche Anzahl lesbarer Bytes bereitstellen, und das Ziel muss beschreibbare Bytes bereitstellen. Die Bereiche dürfen sich nicht überlappen: Ein Verstoß gegen diese Anforderung führt zu undefiniertem Verhalten; verwende bei überlappenden Bereichen std::memmove. Die Funktion prüft die Pufferkapazität nicht.
Das Kopieren der vollständigen Repräsentation zwischen verschiedenen Objekten desselben trivial kopierbaren Typs erhält den Wert, sofern keines davon ein potenziell überlappendes Unterobjekt ist. Betrachte diesen Vorgang nicht als Ersatz für Kopierkonstruktoren oder Zuweisung bei Objekten, die Ressourcen verwalten. Implizites Erzeugen von Objekten hebt Einschränkungen bezüglich Lebensdauer und Typen nicht auf.
Im Beispiel umfasst sizeof src das gesamte Array, nicht die Größe eines Zeigers. Beide Arrays enthalten int und belegen getrennte Speicherbereiche. Die erwartete Ausgabe ist 10 20 30, gefolgt von einem Zeilenumbruch.
Beispiele
#include <cstring>
#include <iostream>
int main() {
const int src[] = {10, 20, 30};
int dest[3] = {};
std::memcpy(dest, src, sizeof src);
std::cout << dest[0] << ' ' << dest[1] << ' ' << dest[2] << '\n';
}
Ergebnis
10 20 30
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.