Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes