Пространства имён
Варианты
Действия

std::uninitialized_value_construct

Материал из cppreference.com
< cpp‎ | memory
 
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
Трёхстороннее сравнение (C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
Общие утилиты
Дата и время
Функциональные объекты
Библиотека форматирования (C++20)
(C++11)
Операторы отношения (устарело в C++20)
Целочисленные функции сравнения
(C++20)(C++20)(C++20)    
(C++20)
��перации обмена и типа
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
 
Динамическое управление памятью
no section name
uninitialized_value_construct
(C++17)
(C++17)
(C++17)
(C++20)
Ограниченные алгоритмы неинициализированной памяти
no section name
Поддержка сбора мусора
(C++11)(до C++23)
(C++11)(до C++23)
(C++11)(до C++23)
(C++11)(до C++23)
(C++11)(до C++23)
(C++11)(до C++23)



no section name
 
Определено в заголовочном файле <memory>
template< class ForwardIt >
void uninitialized_value_construct( ForwardIt first, ForwardIt last );
(1) (начиная с C++17)
template< class ExecutionPolicy, class ForwardIt >

void uninitialized_value_construct( ExecutionPolicy&& policy,

                                    ForwardIt first, ForwardIt last );
(2) (начиная с C++17)
1) Создаёт объекты типа typename iterator_traits<ForwardIt>::value_type в неинициализированной памяти, определяемой диапазоном [firstlast), инициализацией значением, как если бы for (; first != last; ++first)
    ::new (static_cast<void*>(std::addressof(*first)))
        typename std::iterator_traits<ForwardIt>::value_type();
Если во время инициализации возникает исключение, уже созданные объекты уничтожаются в неопределённом порядке.
2) То же, что и (1), но выполняется в соответствии с policy. Эта перегрузка не участвует в разрешении перегрузки, если только

std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> не равно true.

(до C++20)

std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> не равно true.

(начиная с C++20)

Содержание

[править] Параметры

first, last диапазон элементов для инициализации
policy используемая политика выполнения. Подробнее смотрите политика выполнения.
Требования к типам
-
ForwardIt должен соответствовать требованиям LegacyForwardIterator.
-
Никакое инкрементирование, присваивание, сравнение или косвенное обращение через действительные экземпляры ForwardIt не могут вызывать исключения.

[править] Возвращаемое значение

(нет)

[править] Сложность

Линейная по расстоянию между first и last.

[править] Исключения

Перегрузка с параметром шаблона по имени ExecutionPolicy сообщает об ошибках следующим образом:

  • Если выполнение функции, вызванной как часть алгоритма, вызывает исключение и ExecutionPolicy является одной из стандартных политик, вызывается std::terminate. Для любой другой ExecutionPolicy поведение определяется реализацией.
  • Если алгоритму не удаётся выделить память, генерируется std::bad_alloc.

[править] Возможная реализация

template<class ForwardIt>
void uninitialized_value_construct(ForwardIt first, ForwardIt last)
{
    using Value = typename std::iterator_traits<ForwardIt>::value_type;
    ForwardIt current = first;
    try
    {
        for (; current != last; ++current)
            ::new (const_cast<void*>(static_cast<const volatile void*>(
                std::addressof(*current)))) Value();
    }
    catch (...)
    {
        std::destroy(first, current);
        throw;
    }
}

[править] Пример

#include <iostream>
#include <memory>
#include <string>
 
int main()
{
    struct S { std::string m{"Значение по умолчанию"}; };
 
    constexpr int n{3};
    alignas(alignof(S)) unsigned char mem[n * sizeof(S)];
 
    try
    {
        auto first{reinterpret_cast<S*>(mem)};
        auto last{first + n};
 
        std::uninitialized_value_construct(first, last);
 
        for (auto it{first}; it != last; ++it)
            std::cout << it->m << '\n';
 
        std::destroy(first, last);
    }
    catch (...)
    {
        std::cout << "Исключение!\n";
    }
 
    // Обратите внимание, что для "тривиальных типов" uninitialized_value_construct
    // заполняет нулями заданную неинициализированную область памяти.
    int v[]{1, 2, 3, 4};
    for (const int i : v)
        std::cout << i << ' ';
    std::cout << '\n';
    std::uninitialized_value_construct(std::begin(v), std::end(v));
    for (const int i : v)
        std::cout << i << ' ';
    std::cout << '\n';
}

Вывод:

Значение по умолчанию
Значение по умолчанию
Значение по умолчанию
1 2 3 4
0 0 0 0

[править] Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер Применён Поведение в стандарте Корректное поведение
LWG 3870 C++20 этот алгоритм может создавать объекты в const хранилище запрещено

[править] Смотрите также

создаёт объекты инициализацией значением в неинициализированной области памяти, определяемой началом и количеством
(шаблон функции) [править]
создаёт объекты инициализацией по умолчанию в неинициализированной области памяти, определяемой диапазоном
(шаблон функции) [править]
создаёт объекты инициализацией значением в неинициализированной области памяти, определяемой диапазоном
(ниблоид) [править]