std::pmr::polymorphic_allocator::allocate_bytes - cppreference.com (original) (raw)

Allocates nbytes bytes of storage at specified alignment alignment using the underlying memory resource. Equivalent to return resource()->allocate(nbytes, alignment);.

[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

| | allocates raw memory suitable for an object or an array (public member function) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | allocates and constructs an object (public member function) [edit] | | | allocate memory (public member function) [edit] | | | allocates uninitialized storage using the allocator (public static member function of std::allocator_traits) [edit] | | | allocates memory (public member function of std::pmr::memory_resource) [edit] |