std:: align

Dado un puntero ptr a un búfer de tamaño space , devuelve un puntero alineado según la alignment especificada para size número de bytes y disminuye el argumento space por el número de bytes utilizados para la alineación. Se devuelve la primera dirección alineada.

La función modifica el puntero solo si sería posible ajustar el número deseado de bytes alineados por la alineación dada en el búfer. Si el búfer es demasiado pequeño, la función no hace nada y devuelve nullptr .

El comportamiento es indefinido si alignment no es una potencia de dos.

Parámetros

Valor de retorno

El valor ajustado de ptr , o valor de puntero nulo si el espacio proporcionado es demasiado pequeño.

Ejemplo

#include <iostream>
#include <memory>
#include <new>
template<std::size_t N>
struct MyAllocator
{
    std::byte data[N];
    std::size_t sz{N};
    void* p{data};
    MyAllocator() = default;
    // Nota: solo está bien definido para tipos de duración implícita
    template<typename T>
    T* implicit_aligned_alloc(std::size_t a = alignof(T))
    {
        if (std::align(a, sizeof(T), p, sz))
        {
            T* result = std::launder(reinterpret_cast<T*>(p));
            p = static_cast<std::byte*>(p) + sizeof(T);
            sz -= sizeof(T);
            return result;
        }
        return nullptr;
    }
};
int main()
{
    MyAllocator<64> a;
    std::cout << "allocated a.data at " << (void*)a.data
              << " (" << sizeof a.data << " bytes)\n";
    // Asignar un char
    if (char* p = a.implicit_aligned_alloc<char>())
    {
        *p = 'a';
        std::cout << "allocated a char at " << (void*)p << '\n';
    }
    // Asignar un int
    if (int* p = a.implicit_aligned_alloc<int>())
    {
        *p = 1;
        std::cout << "allocated an int at " << (void*)p << '\n';
    }
    // Asignar un int, alineado en un límite de 32 bytes
    if (int* p = a.implicit_aligned_alloc<int>(32))
    {
        *p = 2;
        std::cout << "allocated an int at " << (void*)p << " (32-byte alignment)\n";
    }
}

allocated a.data at 0x7ffc654e8530 (64 bytes)
allocated a char at 0x7ffc654e8530
allocated an int at 0x7ffc654e8534
allocated an int at 0x7ffc654e8540 (32-byte alignment)

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

Véase también