Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::memcpy — copiare byte di memoria

std::memcpy di <cstring> copia un numero specificato di byte tra aree di memoria non sovrapposte. Non controlla i limiti e non sostituisce la copia di oggetti che gestiscono risorse.

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

Sintassi

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

std::memcpy(dest, src, count) di <cstring> copia count byte da src a dest, non count elementi. Non si ferma in corrispondenza di un byte zero. Restituisce un puntatore a un oggetto creato implicitamente adatto oppure, se non ne esiste uno, il valore di dest.

La sorgente deve fornire il numero richiesto di byte leggibili e la destinazione deve fornire byte scrivibili. Le aree non devono sovrapporsi: violare questo requisito causa un comportamento indefinito; usa std::memmove per aree sovrapposte. La funzione non controlla la capacità dei buffer.

La copia della rappresentazione completa tra oggetti distinti dello stesso tipo banalmente copiabile conserva il valore, purché nessuno dei due sia un sotto-oggetto potenzialmente sovrapposto. Non considerare questa operazione un sostituto dei costruttori di copia o dell’assegnazione per oggetti che gestiscono risorse. La creazione implicita di oggetti non elimina i vincoli relativi alla durata e ai tipi.

Nell’esempio, sizeof src comprende l’intero array, non la dimensione di un puntatore. Entrambi gli array contengono int e occupano aree di memoria separate. L’output previsto è 10 20 30 seguito da un carattere di nuova riga.

Esempi

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

Risultato

10 20 30

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti