cpp / latest / memory / allocation_result.html /

std::allocation_result

Defined in header <memory>
template< class Pointer >
struct allocation_result {
    Pointer ptr;
    std::size_t count;
};
(since C++23)

allocation_result specializations are return types of the allocate_at_least member function of appropriate Allocator types (e.g. std::allocator::allocate_at_least) and std::allocate_at_least.

Every specialization of allocation_result has no base classes or declared members other than ptr and count, thus it is suitable for aggregate initialization and structured binding.

Template parameters

Pointer - typically std::allocator_traits<Alloc>::pointer, where Alloc is an Allocator type

Member objects

ptr
(C++23)
typically used for the address of the first element in the storage allocated by allocate_at_least
(public member object)
count
(C++23)
typically used for the actual number of elements in the storage allocated by allocate_at_least
(public member object)

Notes

Feature testing macro: __cpp_lib_allocate_at_least.

Example

See also

(C++23)
allocates uninitialized storage at least as large as requested size
(public member function of std::allocator<T>)
(C++23)
allocates storage at least as large as the requested size via an allocator
(function template)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/memory/allocation_result