Namespaces
Variants
Views
Actions

C++ named requirements: DefaultInsertable

From cppreference.com
< cpp‎ | named req
 
 
C++ named requirements
Basic
Type properties
Library-Wide
Container
Container Elements
DefaultInsertable
(C++11)
Iterator
Stream I/O
Random Numbers
Concurrency
(C++11)

(C++11)
(C++11)
Other
 

Specifies that an instance of the type can be default-constructed in-place by a given allocator.

[edit] Requirements

The type T is DefaultInsertable into the Container X whose value_type is identical to T if, given

A an allocator type
m an lvalue of type A
p the pointer of type T* prepared by the container

where X::allocator_type is identical to std::allocator_traits<A>::rebind_alloc<T>,

the following expression is well-formed:

std::allocator_traits<A>::construct(m, p);


If X is not allocator-aware, the term is defined as if A were std::allocator<T>, except that no allocator object needs to be created, and user-defined specializations of std::allocator are not instantiated.

[edit] Notes

By default, this will call placement-new, as by ::new((void*)p) T() (that is, value-initialize the object pointed to by p). If value-initialization is undesirable, for example, if the object is of non-class type and zeroing out is not needed, it can be avoided by providing a custom Allocator::construct.

[edit] See also

DefaultConstructible
CopyInsertable
MoveInsertable
EmplaceConstructible
Erasable