Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje