Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::align_val_t — tipo del argumento de alineación de memoria

std::align_val_t, de <new>, lleva una alineación requerida a las sobrecargas de asignación y desasignación. Es un tipo de enumeración distinto que permite diferenciar un argumento de alineación de uno que indica el tamaño del almacenamiento.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <new>
// Declaration in namespace std:
enum class align_val_t : size_t {};

// Explicit aligned allocation and matching deallocation:
void* p = ::operator new(sizeof(T), std::align_val_t{alignof(T)});
::operator delete(p, std::align_val_t{alignof(T)});

std::align_val_t es una enumeración con ámbito declarada en <new>, sin enumeradores con nombre y cuyo tipo subyacente es std::size_t. Un valor como std::align_val_t{alignof(T)} indica la alineación requerida en bytes, no el tamaño de la asignación. Su tipo distinto diferencia las sobrecargas que aceptan una alineación de las que aceptan un tamaño.

Para new T, cuando la alineación del tipo supera __STDCPP_DEFAULT_NEW_ALIGNMENT__, la selección de la función de asignación considera primero un argumento de alineación de tipo std::align_val_t. Las sobrecargas propias de una clase pueden afectar a la selección; el código habitual no necesita pasar este argumento manualmente.

Una llamada directa a ::operator new(size, alignment) asigna almacenamiento, pero no invoca un constructor de T. Libere ese almacenamiento con el ::operator delete(ptr, alignment) correspondiente, pasando el mismo valor de alineación. No mezcle estas funciones con free, la desasignación normal sin alineación ni las formas para arrays. En C++23, liberar almacenamiento asignado dinámicamente puede poner fin a la vida de un objeto sin invocar su destructor, aunque este no sea trivial. La liberación del almacenamiento no invoca implícitamente el destructor, por lo que no se ejecutan sus operaciones de limpieza ni se producen sus demás efectos secundarios.

La conversión a std::align_val_t no valida la alineación: pasar un valor no válido a funciones de asignación o desasignación provoca comportamiento indefinido. Use alignof(T) en vez de adivinar qué valores se admiten. En el ejemplo, placement new inicializa un int, se copia el resultado y se libera el almacenamiento antes de imprimir. int no necesita una llamada explícita al destructor.

Ejemplos

#include <iostream>
#include <new>

int main() {
    constexpr auto alignment = std::align_val_t{alignof(int)};
    void* storage = ::operator new(sizeof(int), alignment);
    int* value = ::new (storage) int{42};
    const int result = *value;
    ::operator delete(storage, alignment);
    std::cout << result << '\n';
}

Resultado

42

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.

Fuentes