Namespaces
Variants
Views
Actions

std::uninitialized_construct_using_allocator

From cppreference.com
< cpp‎ | memory
 
 
Utilities library
General utilities
Date and time
Function objects
Formatting library (C++20)
(C++11)
Relational operators (deprecated in C++20)
Integer comparison functions
(C++20)(C++20)(C++20)   
(C++20)
Swap and type operations
(C++14)
(C++11)

(C++11)
(C++11)
(C++17)
Common vocabulary types
(C++11)
(C++17)
(C++17)
(C++17)
(C++23)
(C++11)
(C++17)

Elementary string conversions
(C++17)
(C++17)
 
Dynamic memory management
Smart pointers
(C++11)
(C++11)
(C++11)
(until C++17)
(C++11)
(C++23)
Allocators
uninitialized_construct_using_allocator
(C++20)
Memory resources
Uninitialized storage
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Garbage collection support
(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)
Miscellaneous
(C++20)
(C++11)
(C++11)
 
Defined in header <memory>
template< class T, class Alloc, class... Args >
constexpr T* uninitialized_construct_using_allocator( T* p, const Alloc& alloc, Args&&... args );
(since C++20)

Creates an object of the given type T by means of uses-allocator construction at the uninitialized memory location indicated by p

Equivalent to

return std::apply([&]<class... Xs>(Xs&&...xs) {
        return std::construct_at(p, std::forward<Xs>(xs)...);
    }, std::uses_allocator_construction_args<T>(alloc, std::forward<Args>(args)...));

Contents

[edit] Parameters

p - the memory location where the object will be placed.
alloc - the allocator to use.
args - the arguments to pass to T's constructor

[edit] Return value

Pointer to the newly-created object of type T

[edit] Exceptions

May throw any exception thrown by the constructor of T, typically including std::bad_alloc

[edit] Example

[edit] See also

checks if the specified type supports uses-allocator construction
(class template) [edit]
creates an object of the given type by means of uses-allocator construction
(function template) [edit]