CKTIS / C++
std::memcpy e a representação de objetos de tipos trivialmente copiáveis
Aprende quando a cópia de bytes preserva o valor de um objeto em C++23 e por que razão não substitui a cópia de objetos de qualquer tipo.
Versão: ISO C++23; implementation support may vary
Sintaxe
#include <cstring>
// Call: destination first; count is in bytes.
std::memcpy(dest, src, count);std::memcpy(dest, src, count), declarada em <cstring>, copia exatamente count bytes da origem para o destino. Ambos os ponteiros têm de ser válidos e não nulos, mesmo quando count == 0. O intervalo de origem tem de permitir leitura e o de destino, escrita. Uma cópia fora dos limites ou entre intervalos sobrepostos provoca comportamento indefinido, não uma indicação de erro. Se houver sobreposição, usa std::memmove; os outros requisitos mantêm-se.
A representação de um objeto completo do tipo T ocupa sizeof(T) bytes. Os bits que codificam o valor formam a representação do valor; os restantes são bits de preenchimento. Para um tipo de objeto completo T, verifica se é trivialmente copiável com std::is_trivially_copyable_v<T> de <type_traits>. Esta característica do tipo não verifica os ponteiros nem os intervalos.
Se copiares os sizeof(T) bytes de um objeto inicializado para outro objeto do mesmo tipo trivialmente copiável T, já em vida e gravável, o destino adquire o valor da origem. Nenhum dos dois pode ser um subobjeto potencialmente sobreposto: um subobjeto de classe base ou um membro de dados não estático marcado com [[no_unique_address]]. Também podes guardar a representação de um objeto que cumpra estas condições num array de char, unsigned char ou std::byte e repor os bytes inalterados nesse mesmo objeto.
Em C++23, antes da cópia, a operação pode iniciar implicitamente o tempo de vida de objetos de tipos com tempo de vida implícito em memória de destino devidamente alinhada, se isso permitir um comportamento definido. Não chama construtores nem inicia o tempo de vida de subobjetos cujos tipos não tenham tempo de vida implícito. O resultado do tipo void* aponta para um objeto criado adequado, se existir; caso contrário, é dest.
Para copiar um std::string, usa o construtor de cópia ou a atribuição, não uma cópia dos seus bytes. Copiar o valor de um ponteiro não copia o objeto para o qual aponta. O preenchimento pode fazer com que std::memcmp distinga valores iguais; como a disposição em memória e a ordem dos bytes dependem da implementação, a representação em bruto não é um formato portável. Descodifica e valida dados de origem não fiável segundo um formato definido, em vez de tratares bytes arbitrários como um valor válido do tipo T.
Exemplos
#include <cstddef>
#include <cstring>
#include <iostream>
#include <type_traits>
struct Record {
int id;
int score;
};
static_assert(std::is_trivially_copyable_v<Record>);
int main() {
Record source{7, 42};
Record target{};
std::memcpy(&target, &source, sizeof(Record));
std::cout << "copy: " << target.id << ' ' << target.score << '\n';
std::byte saved[sizeof(Record)];
std::memcpy(saved, &source, sizeof(Record));
source = Record{0, 0};
std::memcpy(&source, saved, sizeof(Record));
std::cout << "restored: " << source.id << ' ' << source.score << '\n';
}Resultado
copy: 7 42 restored: 7 42
`static_assert` verifica o tipo `Record`. O programa copia o valor para `target` e depois repõe o valor original de `source` a partir de `saved`. Mostra os valores dos membros, não os bytes em bruto.
Lições relacionadas
- C++ · Lição 16 · Avançado · Versão: 3