KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::memcpy — geheugenbytes kopiëren

std::memcpy uit <cstring> kopieert een opgegeven aantal bytes tussen niet-overlappende geheugengebieden. De functie controleert geen grenzen en vervangt niet het kopiëren van objecten die resources beheren.

Versie: 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) uit <cstring> kopieert count bytes van src naar dest, niet count elementen. De functie stopt niet bij een nulbyte. Ze retourneert een pointer naar een geschikt impliciet aangemaakt object of, als er geen dergelijk object is, de waarde van dest.

De bron moet het vereiste aantal leesbare bytes bieden en de bestemming moet beschrijfbare bytes bieden. De gebieden mogen elkaar niet overlappen: schending van deze eis leidt tot ongedefinieerd gedrag; gebruik std::memmove bij overlappende gebieden. De functie controleert de buffercapaciteit niet.

Het kopiëren van de volledige representatie tussen afzonderlijke objecten van hetzelfde triviaal kopieerbare type behoudt de waarde, mits geen van beide een mogelijk overlappend subobject is. Beschouw deze bewerking niet als vervanging voor kopieerconstructors of toewijzing van objecten die resources beheren. Impliciete objectcreatie heft beperkingen rond levensduur en typen niet op.

In het voorbeeld omvat sizeof src de volledige array, niet de grootte van een pointer. Beide arrays bevatten int en nemen afzonderlijke geheugengebieden in. De verwachte uitvoer is 10 20 30, gevolgd door een regeleinde.

Voorbeelden

#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';
}

Resultaat

10 20 30

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen