База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::memcpy — копиране на байтове от паметта

std::memcpy от <cstring> копира зададен брой байтове между неприпокриващи се области от паметта. Не проверява границите и не замества копирането на обекти, които управляват ресурси.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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

std::memcpy(dest, src, count) от <cstring> копира count байта от src в dest, а не count елемента. Не спира при нулев байт. Връща указател към подходящ имплицитно създаден обект или, ако няма такъв, стойността на dest.

Източникът трябва да предоставя необходимия брой четими байтове, а целта — байтове, в които може да се записва. Областите не трябва да се припокриват: нарушаването на това изискване води до неопределено поведение; при припокриващи се области използвайте std::memmove. Функцията не проверява капацитета на буферите.

Копирането на цялото представяне между отделни обекти от един и същ тривиално копируем тип запазва стойността, при условие че никой от тях не е потенциално припокриващ се подобект. Не разглеждайте тази операция като заместител на конструкторите за копиране или присвояването при обекти, които управляват ресурси. Имплицитното създаване на обекти не премахва ограниченията за времето на живот и типовете.

В примера sizeof src обхваща целия масив, а не размера на указател. И двата масива съдържат int и заемат отделни области от паметта. Очакваният изход е 10 20 30, последван от нов ред.

Примери

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

Резултат

10 20 30

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници