CKTIS / C++
std::memcpy — copiar bytes de memória
std::memcpy de <cstring> copia um número especificado de bytes entre regiões de memória que não se sobrepõem. Não verifica limites nem substitui a cópia de objetos que gerem recursos.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <cstring>
void* std::memcpy(void* dest, const void* src, std::size_t count);std::memcpy(dest, src, count) de <cstring> copia count bytes de src para dest, e não count elementos. Não para num byte zero. Devolve um ponteiro para um objeto implicitamente criado adequado ou, se não existir nenhum, o valor de dest.
A origem tem de disponibilizar o número necessário de bytes legíveis, e o destino tem de disponibilizar bytes graváveis. As regiões não se podem sobrepor: violar este requisito causa comportamento indefinido; utiliza std::memmove quando as regiões se sobrepõem. A função não verifica a capacidade dos buffers.
Copiar a representação completa entre objetos distintos do mesmo tipo trivialmente copiável preserva o valor, desde que nenhum deles seja um subobjeto potencialmente sobreposto. Não consideres esta operação um substituto dos construtores de cópia ou da atribuição de objetos que gerem recursos. A criação implícita de objetos não elimina as restrições relativas ao tempo de vida e aos tipos.
No exemplo, sizeof src abrange todo o array, não o tamanho de um ponteiro. Ambos os arrays contêm int e ocupam regiões de memória separadas. O resultado esperado é 10 20 30 seguido de uma mudança de linha.
Exemplos
#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';
}
Resultado
10 20 30
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.