std::pmr::polymorphic_allocator<T>::allocate (3) - Linux Manuals

std::pmr::polymorphic_allocator<T>::allocate: std::pmr::polymorphic_allocator<T>::allocate

NAME

std::pmr::polymorphic_allocator<T>::allocate - std::pmr::polymorphic_allocator<T>::allocate

Synopsis


T* allocate( std::size_t n ); (since C++17)
                                             (until C++20)
[[nodiscard]] T* allocate( std::size_t n ); (since C++20)


Allocates storage for n objects of type T using the underlying memory resource. Equivalent to return static_cast<T*>(resource()->allocate(n * sizeof(T), alignof(T)));.

Parameters


n - the number of objects to allocate storage for

Return value


A pointer to the allocated storage.

Exceptions


Throws std::length_error if n > SIZE_MAX / sizeof(T); may also any exceptions thrown by the call to resource()->allocate.

See also


allocate_bytes Allocate raw aligned memory from the underlying resource
                (public member function)
(C++20)


allocate_object Allocates raw memory suitable for an object or an array
                (public member function)
(C++20)


new_object Allocates and constructs an object
                (public member function)
(C++20)


allocate allocates uninitialized storage using the allocator
                (public static member function of std::allocator_traits<Alloc>)
[static]
                allocates memory
allocate (public member function of std::pmr::memory_resource)