CKTIS / C++
std::memcpy — kopírování bajtů paměti
std::memcpy z <cstring> kopíruje zadaný počet bajtů mezi nepřekrývajícími se oblastmi paměti. Nekontroluje hranice a nenahrazuje kopírování objektů, které spravují prostředky.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstring>
void* std::memcpy(void* dest, const void* src, std::size_t count);std::memcpy(dest, src, count) z <cstring> kopíruje count bajtů z src do dest, nikoli count prvků. Nezastaví se u nulového bajtu. Vrací ukazatel na vhodný implicitně vytvořený objekt, nebo pokud žádný takový není, hodnotu dest.
Zdroj musí poskytovat požadovaný počet čitelných bajtů a cíl musí poskytovat zapisovatelné bajty. Oblasti se nesmějí překrývat: porušení tohoto požadavku vede k nedefinovanému chování; pro překrývající se oblasti použijte std::memmove. Funkce nekontroluje kapacitu bufferů.
Kopírování úplné reprezentace mezi samostatnými objekty stejného triviálně kopírovatelného typu zachová hodnotu, pokud žádný z nich není potenciálně se překrývajícím podobjektem. Nepovažujte tuto operaci za náhradu kopírovacích konstruktorů ani přiřazení u objektů, které spravují prostředky. Implicitní vytváření objektů neruší omezení týkající se doby života a typů.
V příkladu zahrnuje sizeof src celé pole, nikoli velikost ukazatele. Obě pole obsahují int a zaujímají oddělené oblasti paměti. Očekávaný výstup je 10 20 30 následovaný znakem nového řádku.
Příklady
#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';
}
Výsledek
10 20 30
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.