std::assume_aligned

template< std::size_t N, class T >
constexpr T* assume_aligned( T* ptr );

Сообщает реализации, что объект, на который указывает ptr, выровнен как минимум по границе N. Реализация может использовать эту информацию для генерации более эффективного кода, но делать такое предположение она может только в том случае, если к объекту обращаются через возвращаемое значение assume_aligned.

N должно быть степенью двойки. Поведение не определено, если ptr не указывает на объект типа T (без учёта cv-квалификаторов на каждом уровне) или если выравнивание объекта меньше N.

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

ptr.

Исключения

Не генерирует исключений.

Примечания

Чтобы программа могла воспользоваться оптимизациями, включаемыми с помощью assume_aligned, важно обращаться к объекту через возвращаемое значение:

void f(int* p)
{
    int* p1 = std::assume_aligned<256>(p);
    // Use p1, not p, to ensure benefit from the alignment assumption.
    // However, the program has undefined behavior if p is not aligned
    // regardless of whether p1 is used.
}

Программа должна сама гарантировать, что предположение о выравнивании действительно выполняется. Вызов assume_aligned не заставляет компилятор проверять или обеспечивать это.

Пример

См. также