Namespaces
Variants

std::ranges:: uninitialized_default_construct

From cppreference.net
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
Определено в заголовке <memory>
Сигнатура вызова
template < no-throw-forward-iterator I, no - throw - sentinel - for < I > S >

requires std:: default_initializable < std:: iter_value_t < I >>

I uninitialized_default_construct ( I first, S last ) ;
(1) (начиная с C++20)
(constexpr начиная с C++26)
template < no-throw-forward-range R >

requires std:: default_initializable < ranges:: range_value_t < R >>
ranges:: borrowed_iterator_t < R >

uninitialized_default_construct ( R && r ) ;
(2) (начиная с C++20)
(constexpr начиная с C++26)
1) Создает объекты типа std:: iter_value_t < I > в неинициализированной области памяти [ first , last ) с помощью default-инициализации , как если бы:

for ( ; first ! = last ; ++ first )
:: new ( voidify ( * first ) )
std:: remove_reference_t < std:: iter_reference_t < I >> ;
return first ;

Если во время инициализации возникает исключение, уже созданные объекты уничтожаются в неопределенном порядке.
2) Эквивалентно ranges :: uninitialized_default_construct ( ranges:: begin ( r ) , ranges:: end ( r ) ) .

Функциональные сущности, описанные на этой странице, являются algorithm function objects (неформально известными как niebloids ), то есть:

  • Явные списки аргументов шаблона не могут быть указаны при вызове любого из них.
  • Ни один из них не видим для argument-dependent lookup .
  • Когда любой из них найден с помощью normal unqualified lookup как имя слева от оператора вызова функции, argument-dependent lookup блокируется.

Содержание

Параметры

first, last - пара итератор-страж, определяющая диапазон элементов для инициализации
r - range элементов для инициализации

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

Как описано выше.

Сложность

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

Исключения

Любое исключение, выброшенное при конструировании элементов в целевом диапазоне.

Примечания

Реализация может пропустить создание объектов (без изменения наблюдаемого эффекта), если при инициализации по умолчанию объекта std:: iter_value_t < I > не вызывается нетривиальный конструктор по умолчанию, что может быть обнаружено с помощью std::is_trivially_default_constructible .

Макрос тестирования возможностей Значение Стандарт Возможность
__cpp_lib_raw_memory_algorithms 202411L (C++26) constexpr для специализированных алгоритмов работы с памятью , ( 1,2 )

Возможная реализация

struct uninitialized_default_construct_fn
{
    template<no-throw-forward-iterator I, no-throw-sentinel-for<I> S>
        requires std::default_initializable<std::iter_value_t<I>>
    constexpr I operator()(I first, S last) const
    {
        using ValueType = std::remove_reference_t<std::iter_reference_t<I>>;
        if constexpr (std::is_trivially_default_constructible_v<ValueType>)
            return ranges::next(first, last); // пропустить инициализацию
        I rollback{first};
        try
        {
            for (; !(first == last); ++first)
                ::new (static_cast<void*>(std::addressof(*first))) ValueType;
            return first;
        }
        catch (...) // откат: уничтожить созданные элементы
        {
            for (; rollback != first; ++rollback)
                ranges::destroy_at(std::addressof(*rollback));
            throw;
        }
    }
    template<no-throw-forward-range R>
        requires std::default_initializable<ranges::range_value_t<R>>
    constexpr ranges::borrowed_iterator_t<R> operator()(R&& r) const
    {
        return (*this)(ranges::begin(r), ranges::end(r));
    }
};
inline constexpr uninitialized_default_construct_fn uninitialized_default_construct{};

Пример

#include <cstring>
#include <iostream>
#include <memory>
#include <string>
int main()
{
    struct S { std::string m{"▄▀▄▀▄▀▄▀"}; };
    constexpr int n{4};
    alignas(alignof(S)) char out[n * sizeof(S)];
    try
    {
        auto first{reinterpret_cast<S*>(out)};
        auto last{first + n};
        std::ranges::uninitialized_default_construct(first, last);
        auto count{1};
        for (auto it{first}; it != last; ++it)
            std::cout << count++ << ' ' << it->m << '\n';
        std::ranges::destroy(first, last);
    }
    catch (...) { std::cout << "Exception!\n"; }
    // Обратите внимание, что для "тривиальных типов" uninitialized_default_construct
    // обычно не заполняет нулями данную неинициализированную область памяти.
    constexpr char sample[]{'A', 'B', 'C', 'D', '\n'};
    char v[]{'A', 'B', 'C', 'D', '\n'};
    std::ranges::uninitialized_default_construct(std::begin(v), std::end(v));
    if (std::memcmp(v, sample, sizeof(v)) == 0)
    {
        std::cout << "  ";
        // Возможно неопределенное поведение, ожидается разрешение CWG 1997:
        // for (const char c : v) { std::cout << c << ' '; }
        for (const char c : sample)
            std::cout << c << ' ';
    }
    else
        std::cout << "Unspecified\n";
}

Возможный вывод:

1 ▄▀▄▀▄▀▄▀
2 ▄▀▄▀▄▀▄▀
3 ▄▀▄▀▄▀▄▀
4 ▄▀▄▀▄▀▄▀
  A B C D

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

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

DR Applied to Behavior as published Correct behavior
LWG 3870 C++20 этот алгоритм может создавать объекты в const хранилище оставлено запрещенным

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

создаёт объекты с помощью default-initialization в неинициализированной области памяти, заданной началом и количеством
(объект-функция алгоритма)
создаёт объекты с помощью value-initialization в неинициализированной области памяти, заданной диапазоном
(объект-функция алгоритма)
создаёт объекты с помощью value-initialization в неинициализированной области памяти, заданной началом и количеством
(объект-функция алгоритма)
создаёт объекты с помощью default-initialization в неинициализированной области памяти, заданной диапазоном
(шаблон функции)