Difference between revisions of "cpp/memory/polymorphic allocator/allocate bytes"
From cppreference.com
< cpp | memory | polymorphic allocator
m (→See also) |
D41D8CD98F (Talk | contribs) (- nodiscard) |
||
| Line 4: | Line 4: | ||
{{dcl begin}} | {{dcl begin}} | ||
{{dcl|since=c++20|1= | {{dcl|since=c++20|1= | ||
| − | + | void* allocate_bytes( std::size_t nbytes, | |
| − | + | std::size_t alignment = alignof(std::max_align_t) ); | |
}} | }} | ||
{{dcl end}} | {{dcl end}} | ||
Latest revision as of 02:48, 1 July 2024
| void* allocate_bytes( std::size_t nbytes, std::size_t alignment = alignof(std::max_align_t) ); |
(since C++20) | |
Allocates nbytes bytes of storage at specified alignment alignment using the underlying memory resource. Equivalent to return resource()->allocate(nbytes, alignment);.
Contents |
[edit] Parameters
| nbytes | - | the number of bytes to allocate |
| alignment | - | the alignment to use |
[edit] Return value
A pointer to the allocated storage.
[edit] Notes
This function was introduced for use with the fully-specialized allocator std::pmr::polymorphic_allocator<>, but it may be useful in any specialization.
The return type is void* (rather than, e.g., std::byte*) to support conversion to an arbitrary pointer type U* by static_cast<U*>.
[edit] Exceptions
May throw any exceptions thrown by the call to resource()->allocate.
[edit] See also
| (C++20) |
allocates raw memory suitable for an object or an array (public member function) |
| (C++20) |
allocates and constructs an object (public member function) |
| allocate memory (public member function) | |
| [static] |
allocates uninitialized storage using the allocator (public static member function of std::allocator_traits<Alloc>)
|
| allocates memory (public member function of std::pmr::memory_resource)
|
