CKTIS / C++
std::memcpy — kopiranje bajtova memorije
std::memcpy iz <cstring> kopira zadani broj bajtova između memorijskih područja koja se ne preklapaju. Ne provjerava granice i nije zamjena za kopiranje objekata koji upravljaju resursima.
Verzija: 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 bajtova iz src u dest, a ne count elemenata. Ne zaustavlja se na nultom bajtu. Vraća pokazivač na prikladan implicitno stvoren objekt ili, ako takav ne postoji, vrijednost dest.
Izvor mora pružiti potreban broj čitljivih bajtova, a odredište mora pružiti bajtove u koje se može zapisivati. Područja se ne smiju preklapati: kršenje tog zahtjeva uzrokuje nedefinirano ponašanje; za područja koja se preklapaju upotrijebite std::memmove. Funkcija ne provjerava kapacitet međuspremnika.
Kopiranje cjelokupnog prikaza između zasebnih objekata istog trivijalno kopirljivog tipa čuva vrijednost, pod uvjetom da nijedan nije potencijalno preklapajući podobjekt. Nemojte ovu operaciju smatrati zamjenom za kopirne konstruktore ili pridruživanje objekata koji upravljaju resursima. Implicitno stvaranje objekata ne uklanja ograničenja vezana uz životni vijek i tipove.
U primjeru sizeof src obuhvaća cijelo polje, a ne veličinu pokazivača. Oba polja sadrže int i zauzimaju odvojena memorijska područja. Očekivani izlaz je 10 20 30 iza kojeg slijedi novi redak.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.