Просмотр кода страницы cpp/memory/c/aligned alloc

У вас нет прав на выполнение действия «редактирование этой страницы» по следующей причине:

Запрошенное действие могут выполнять участники одной из следующих групп: Участники, Администраторы.

Вы можете просмотреть и скопировать исходный код этой страницы.

{{cpp/title|aligned_alloc}}
{{cpp/memory/navbar}}
{{ddcl|header=cstdlib|since=c++17|
void* aligned_alloc( std::size_t alignment, std::size_t size );
}}

Выделяет {{c|size}} байт неинициализированного хранилища, выравнивание которого определяется {{c|alignment}} ([[cpp/language/object#Создание объекта|неявное создание]] объектов в целевой области). Параметр {{c|size}} должен быть целым числом, кратным {{c|alignment}}.

{{cpp/memory/thread_safety_note}}

===Параметры===
{{par begin}}
{{par|alignment|определяет выравнивание. Должно быть допустимое выравнивание, поддерживаемое реализацией.}}
{{par|size|количество байтов для выделения. Целое кратное {{c|alignment}}.}}
{{par end}}

===Возвращаемое значение===
В случае успеха возвращает указатель на начало выделенной памяти. Чтобы избежать утечки памяти, возвращаемый указатель должен быть освобождён с помощью {{lc|std::free()}} или {{lc|std::realloc()}}.

В случае ошибки возвращает нулевой указатель.

===Примечание===
Передача {{c|size}}, который не является целым кратным {{c|alignment}}, или {{c|alignment}}, который недействителен или не поддерживается реализацией, приводит к сбою функции и возврату нулевого указателя (C11, как опубликовано, в этом случае указано неопределённое поведение, это было исправлено {{stddoc|summary.htm#dr_460|DR460|lang=c}}).

В качестве примера требования "поддержки реализацией", функция POSIX [https://pubs.opengroup.org/onlinepubs/9699919799/functions/posix_memalign.html {{tt|posix_memalign}}] принимает любой {{c|alignment}}, который является степенью двойки и кратен {{c|sizeof(void*)}}, и реализации {{tt|aligned_alloc}} на основе POSIX наследуют эти требования.

Фундаментальные выравнивания поддерживаются всегда. Если {{c|alignment}} является степенью двойки и не превышает {{c|alignof(std::max_align_t)}}, {{tt|aligned_alloc}} может просто вызвать {{lc|std::malloc}}.

Обычная {{lc|std::malloc}} выравнивает память, подходящую для любого типа объекта, с фундаментальным выравниванием. Эта функция полезна для чрезмерного распределения, например, для {{enwikiru|SSE|SSE}}, строки кэша или границы {{enwikiru|Страничная память|страницы VM}}.

Эта функция не поддерживается в Microsoft библиотеке Времени Выполнения C, поскольку её реализация {{lc|std::free}} is [https://learn.microsoft.com/en-us/cpp/standard-library/cstdlib#remarks-6 не может обрабатывать выровненные выделения] любого рода. Вместо этого MS CRT предоставляет [https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/aligned-malloc {{tt|_aligned_malloc}}] (освобождение осуществляется с помощью [https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/aligned-free {{tt|_aligned_free}}]).

===Пример===
{{example|code=
#include <cstdio>
#include <cstdlib>
 
int main()
{
    int* p1 = static_cast<int*>(std::malloc(10*sizeof *p1));
    std::printf("адрес, выровненный по умолчанию:   %p\n", static_cast<void*>(p1));
    std::free(p1);
 
    int* p2 = static_cast<int*>(std::aligned_alloc(1024, 1024));
    std::printf("адрес, выровненный по 1024 байтам: %p\n", static_cast<void*>(p2));
    std::free(p2);
}
|p=true
|output=
адрес, выровненный по умолчанию:   0x2221c20
адрес, выровненный по 1024 байтам: 0x2222400}}

===Смотрите также===
{{dsc begin}}
{{dsc inc|cpp/types/dsc aligned_storage}}
{{dsc see c|c/memory/aligned_alloc}}
{{dsc end}}

{{langlinks|en|es|ja|zh}}

Шаблоны, используемые на этой странице:

cppreference.com

Поиск

Пространства имён

Варианты

Просмотры

Действия

Просмотр кода страницы cpp/memory/c/aligned alloc