Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::memcpy — kopiranje bajtov pomnilnika

std::memcpy iz <cstring> kopira določeno število bajtov med neprekrivajočimi se območji pomnilnika. Ne preverja meja in ne nadomesti kopiranja objektov, ki upravljajo vire.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <cstring>
void* std::memcpy(void* dest, const void* src, std::size_t count);

std::memcpy(dest, src, count) iz <cstring> kopira count bajtov iz src v dest, ne pa count elementov. Pri ničelnem bajtu se ne ustavi. Vrne kazalec na ustrezen implicitno ustvarjen objekt ali, če takega ni, vrednost dest.

Vir mora zagotavljati zahtevano število berljivih bajtov, cilj pa zapisljive bajte. Območji se ne smeta prekrivati: kršitev te zahteve povzroči nedefinirano vedenje; za prekrivajoči se območji uporabi std::memmove. Funkcija ne preverja zmogljivosti medpomnilnikov.

Kopiranje celotne predstavitve med ločenima objektoma istega trivialno kopirljivega tipa ohrani vrednost, če nobeden ni potencialno prekrivajoči se podobjekt. Te operacije ne obravnavaj kot nadomestilo za kopirne konstruktorje ali prirejanje objektov, ki upravljajo vire. Implicitno ustvarjanje objektov ne odpravi omejitev glede življenjske dobe in tipov.

V primeru sizeof src zajema celotno polje, ne velikosti kazalca. Obe polji vsebujeta int in zasedata ločeni območji pomnilnika. Pričakovani izpis je 10 20 30, ki mu sledi nova vrstica.

Primeri

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

Rezultat

10 20 30

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri