std::malloc

void* malloc( std::size_t size );

Выделяет size байта неинициализированного хранилища.

Если выделение выполнено успешно, возвращает указатель на самый низкий (первый) байт в выделенном блоке памяти, который должным образом выровнен для любого скалярного типа (по крайней мере, так же строго, как std::max_align_t) (неявное создание объектов в целевом участке).

Если size равно нулю, поведение определяется реализацией (может быть возвращен нулевой указатель или какой-то ненулевой указатель, который может не использоваться для доступа к хранилищу, но должен передаваться в std::free).

Параметры

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

При успешном выполнении возвращает указатель на начало выделенной памяти. Для предотвращения утечки памяти возвращенный указатель необходимо освободить с помощью std::free() или std::realloc().

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

Примечания

Эта функция не вызывает конструкторы и не инициализирует память. Нет готовых к использованию умных указателей, которые могли бы гарантировать, что вызывается соответствующая функция освобождения. Предпочтительный метод выделения памяти в C++ — использование функций, совместимых с RAII, std::make_unique, std::make_shared, конструкторы контейнеров и т. д., а в коде низкоуровневых библиотек — оператор new.

Для загрузки большого файла предпочтительнее использовать отображение файла с помощью функций, специфичных для операционной системы, например, mmap в POSIX или CreateFileMapping(A/W) вместе с MapViewOfFile в Windows.

Пример

#include <cstdlib> 
#include <iostream>   
#include <memory>
#include <string>
 
int main() 
{
    constexpr std::size_t size = 4;
    if (auto ptr = reinterpret_cast<std::string*>(std::malloc(size * sizeof(std::string))))
    {
        try
        {
            for (std::size_t i = 0; i < size; ++i)
                std::construct_at(ptr + i, 5, 'a' + i);
            for (std::size_t i = 0; i < size; ++i)
                std::cout << "ptr[" << i << "] == " << ptr[i] << '\n';
            std::destroy_n(ptr, size);
        }
        catch (...) {}
        std::free(ptr);
    }
}

p[0] == aaaaa
p[1] == bbbbb
p[2] == ccccc
p[3] == ddddd

См. также