CKTIS / C++
std::memcpy — kopírovanie bajtov pamäte
std::memcpy z <cstring> kopíruje zadaný počet bajtov medzi neprekrývajúcimi sa oblasťami pamäte. Nekontroluje hranice a nenahrádza kopírovanie objektov, ktoré spravujú zdroje.
Verzia: 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) z <cstring> kopíruje count bajtov z src do dest, nie count prvkov. Nezastaví sa pri nulovom bajte. Vráti ukazovateľ na vhodný implicitne vytvorený objekt alebo, ak taký neexistuje, hodnotu dest.
Zdroj musí poskytovať požadovaný počet čitateľných bajtov a cieľ musí poskytovať zapisovateľné bajty. Oblasti sa nesmú prekrývať: porušenie tejto požiadavky vedie k nedefinovanému správaniu; pri prekrývajúcich sa oblastiach použite std::memmove. Funkcia nekontroluje kapacitu bufferov.
Kopírovanie úplnej reprezentácie medzi samostatnými objektmi rovnakého triviálne kopírovateľného typu zachová hodnotu, ak ani jeden z nich nie je potenciálne sa prekrývajúcim podobjektom. Nepovažujte túto operáciu za náhradu kopírovacích konštruktorov ani priradenia objektov, ktoré spravujú zdroje. Implicitné vytváranie objektov neruší obmedzenia týkajúce sa životnosti a typov.
V príklade zahŕňa sizeof src celé pole, nie veľkosť ukazovateľa. Obe polia obsahujú int a zaberajú oddelené oblasti pamäte. Očakávaný výstup je 10 20 30 nasledovaný znakom nového riadka.
Prí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ýsledok
10 20 30
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.