Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::memcpy — kopiowanie bajtów pamięci

std::memcpy z <cstring> kopiuje określoną liczbę bajtów między niepokrywającymi się obszarami pamięci. Nie sprawdza granic i nie zastępuje kopiowania obiektów zarządzających zasobami.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

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

std::memcpy(dest, src, count) z <cstring> kopiuje count bajtów z src do dest, a nie count elementów. Nie zatrzymuje się na bajcie zerowym. Zwraca wskaźnik do odpowiedniego niejawnie utworzonego obiektu albo, gdy takiego obiektu nie ma, wartość dest.

Źródło musi udostępniać wymaganą liczbę bajtów do odczytu, a cel — do zapisu. Obszary nie mogą się pokrywać: naruszenie tego warunku powoduje niezdefiniowane zachowanie; przy nakładaniu użyj std::memmove. Funkcja nie sprawdza pojemności buforów.

Kopiowanie pełnej reprezentacji między odrębnymi obiektami tego samego typu trywialnie kopiowalnego zachowuje wartość, jeśli żaden nie jest podobiektem potencjalnie nakładającym się. Nie traktuj tej operacji jako zamiennika konstruktorów kopiujących ani przypisania obiektów zarządzających zasobami. Niejawne tworzenie obiektów nie znosi ograniczeń czasu życia i typów.

W przykładzie sizeof src obejmuje całą tablicę, a nie rozmiar wskaźnika. Obie tablice zawierają int i zajmują odrębne obszary pamięci. Oczekiwany wynik to 10 20 30 zakończone znakiem nowej linii.

Przykłady

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

Wynik

10 20 30

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła