std::memcpy

Copia una cuenta count de bytes del objeto apuntado por src al objeto apuntado por dest. Ambos objetos se reinterpretan como arrays de unsigned char.

Si los objetos se traslapan, el comportamiento es indefinido.

Si bien dest o src es un puntero inválido o nulo, el comportamiento es indefinido, incluso si count es cero.

Si los objetos potencialmente se traslapan o no son trivialmente copiables (TriviallyCopyable), el comportamiento de memcpy no está especificado y puede estar indefinido.

[editar] Parámetros

[editar] Valor de retorno

dest

[editar] Notas

Se pretende que std::memcpy sea la rutina de biblioteca más rápida para copiar de memoria a memoria. Habitualmente es más eficiente que std::strcpy, que debe escanear los datos que copia, o std::memmove, que debe tomar precauciones para manejar entradas traslapantes.

Varios compiladores de C++ transforman bucles de copiado de memoria adecuados para las llamadas a std::memcpy.

Puede usarse std::memcpy para convertir los valores donde el alias estricto prohibe examinar la misma memoria como valores de dos tipos distintos.

[editar] Ejemplo

#include <iostream>
#include <cstdint>
#include <cstring>
 
int main()
{
    // uso simple
    char source[] = "nada te turbe, nada te espante...", dest[4];
    std::memcpy(dest, source, sizeof dest);
    for (char c : dest)
        std::cout << c << '\n';
 
    // reinterpretando
    double d = 0.1;
//  std::int64_t n = *reinterpret_cast<std::int64_t*>(&d); // violación del alias
    std::int64_t n;
    std::memcpy(&n, &d, sizeof d); // de acuerdo
 
    std::cout << std::hexfloat << d << " es " << std::hex << n
              << " como un std::int64_t\n";
}

n
a
d
a
0x1.999999999999ap-4 es 3fb999999999999a como un std::int64_t

[editar] Véase también