std:: align

Дано указатель ptr на буфер размером space , возвращает указатель, выровненный по заданному alignment для size количества байт и уменьшает аргумент space на количество байт, использованных для выравнивания. Возвращается первый выровненный адрес.

Функция изменяет указатель только в том случае, если в буфере возможно разместить требуемое количество байт, выровненных по заданному alignment. Если буфер слишком мал, функция не выполняет никаких действий и возвращает nullptr .

Поведение не определено, если alignment не является степенью двойки.

Параметры

Возвращаемое значение

Скорректированное значение ptr , или значение нулевого указателя, если предоставленное пространство слишком мало.

Пример

#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;
    // Примечание: корректно определено только для типов с неявным временем жизни
    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";
    // Выделение памяти для char
    if (char* p = a.implicit_aligned_alloc<char>())
    {
        *p = 'a';
        std::cout << "allocated a char at " << (void*)p << '\n';
    }
    // Выделение памяти для int
    if (int* p = a.implicit_aligned_alloc<int>())
    {
        *p = 1;
        std::cout << "allocated an int at " << (void*)p << '\n';
    }
    // Выделение памяти для int с выравниванием по 32-байтной границе
    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)

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также