From cppreference.com
Defined in header
Call signature
template</*nothrow-forward-iterator*/I,/*nothrow-sentinel-for*/<I>S>requiresstd::default_initializable<std::iter_value_t<I>>Iuninitialized_default_construct(Ifirst,Slast); (1)(since C++20)
(constexpr since C++26)template</*nothrow-forward-range*/R>requiresstd::default_initializable<ranges::range_value_t<R>>ranges::borrowed_iterator_t<R>uninitialized_default_construct(R&&r); (2)(since C++20)
(constexpr since C++26)template</*execution-policy*/Ep,/*nothrow-random-access-iterator*/I,/*nothrow-sized-sentinel-for*/<I>S>requiresstd::default_initializable<std::iter_value_t<I>>Iuninitialized_default_construct(Ep&&policy,Ifirst,Slast); (3) (since C++26)template</*execution-policy*/Ep,/*nothrow-sized-random-access-range*/R>requiresstd::default_initializable<ranges::range_value_t<R>>ranges::borrowed_iterator_t<R>uninitialized_default_construct(Ep&&policy,R&&r); (4) (since C++26)For the definition of /*execution-policy*/, see
; for the definition of other exposition-only concepts, see
.
1) Constructs elements in the destination range [first, last) by
as if by
for(;first!=last;++first)
::new(
(*first))
std::remove_reference_t<std::iter_reference_t<I>>;
returnfirst;
If an exception is thrown during the initialization, the objects already constructed are destroyed in an unspecified order.
2) Same as (1), but uses r as the destination range.
3,4) Same as (1,2), but executed according to policy.
The function-like entities described on this page are
(informally known as niebloids), that is:
Explicit template argument lists cannot be specified when calling any of them.
None of them are visible to
.
When any of them are found by
as the name to the left of the function-call operator,
is inhibited.
Parameters
first, last - the iterator-sentinel pair defining the
of elements to initialize r - the
of the elements to initialize policy - the
to use Return value
As described above.
Exceptions
Any exception thrown on construction of the elements in the destination range.
3,4) During the execution process:
If the temporary memory resources required for parallelization are not available,
is thrown.
If an uncaught exception is thrown while accessing objects via an algorithm argument, the behavior is determined by the execution policy (for
,
is invoked).
Notes
An implementation may skip the objects construction (without changing the observable effect) if no non-trivial default constructor is called while default-initializing a std::iter_value_t<I> object, which can be detected by
std::is_trivially_default_constructible
.
macro ValueStdFeature
(C++26)Parallel range algorithms
__cpp_lib_raw_memory_algorithms
(C++26)constexpr for
specialized <memory> algorithms
, (
)Possible implementation
structuninitialized_default_construct_fn{template</*nothrow-forward-iterator*/I,/*nothrow-sentinel-for*/<I>S>requiresstd::default_initializable<std::iter_value_t<I>>constexprIoperator()(Ifirst,Slast)const{usingvalue_type=std::remove_reference_t<std::iter_reference_t<I>>;ifconstexpr(std::is_trivially_default_constructible_v<value_type>)returnranges::next(first,last);// skip initializationIrollback{first};try{for(;!(first==last);++first)::new(static_cast<void*>(std::addressof(*first)))value_type;returnfirst;}catch(...)// rollback: destroy constructed elements{for(;rollback!=first;++rollback)ranges::destroy_at(std::addressof(*rollback));throw;}}template</*nothrow-forward-range*/R>requiresstd::default_initializable<ranges::range_value_t<R>>constexprranges::borrowed_iterator_t<R>operator()(R&&r)const{return(*this)(ranges::begin(r),ranges::next(ranges::begin(r),ranges::end(r)));}};inlineconstexpruninitialized_default_construct_fnuninitialized_default_construct{};Example
Run this code
#include<cstring>#include<iostream>#include<memory>#include<string>intmain(){structS{std::stringm{"▄▀▄▀▄▀▄▀"};};constexprintn{4};alignas(alignof(S))charout[n*sizeof(S)];try{autofirst{reinterpret_cast<S*>(out)};autolast{first+n};std::ranges::uninitialized_default_construct(first,last);autocount{1};for(autoit{first};it!=last;++it)std::cout<<count++<<' '<<it->m<<'\n';std::ranges::destroy(first,last);}catch(...){std::cout<<"Exception!\n";}// Notice that for "trivial types" the uninitialized_default_construct// generally does not zero-fill the given uninitialized memory area.constexprcharsample[]{'A','B','C','D','\n'};charv[]{'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<<" ";// Maybe undefined behavior, pending CWG 1997 to be resolved:// for (const char c : v) { std::cout << c << ' '; }for(constcharc:sample)std::cout<<c<<' ';}elsestd::cout<<"Unspecified\n";}Possible output:
1 ▄▀▄▀▄▀▄▀ 2 ▄▀▄▀▄▀▄▀ 3 ▄▀▄▀▄▀▄▀ 4 ▄▀▄▀▄▀▄▀ A B C D See also