CKTIS / C++
std::memcpy — copiar bytes de memoria
std::memcpy de <cstring> copia un número determinado de bytes entre regiones de memoria que no se solapan. No comprueba los límites ni sustituye la copia de objetos que gestionan recursos.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#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 a dest, no count elementos. No se detiene al encontrar un byte cero. Devuelve un puntero a un objeto implícito creado que sea adecuado o, si no existe, el valor de dest.
El origen debe proporcionar el número necesario de bytes legibles, y el destino debe proporcionar bytes que se puedan escribir. Las regiones no deben solaparse: incumplir este requisito provoca un comportamiento indefinido; usa std::memmove si las regiones se solapan. La función no comprueba la capacidad de los búferes.
Copiar la representación completa entre objetos distintos del mismo tipo trivialmente copiable conserva el valor, siempre que ninguno sea un subobjeto potencialmente solapable. No consideres esta operación un sustituto de los constructores de copia ni de la asignación de objetos que gestionan recursos. La creación implícita de objetos no elimina las restricciones de duración y tipo.
En el ejemplo, sizeof src abarca todo el array, no el tamaño de un puntero. Ambos arrays contienen int y ocupan regiones de memoria distintas. La salida esperada es 10 20 30 seguida de un salto de línea.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.