home | help
std::pmr::p...locate_bytes(3)  C++ Standard Libary std::pmr::p...locate_bytes(3)

NAME
     std::pmr::polymorphic_allocator::allocate_bytes - std::pmr::polymorphic_al-
     locator::allocate_bytes

Synopsis
	[[nodiscard]] void* allocate_bytes( std::size_t nbytes,
					    std::size_t        alignment       =
     (since C++20)
	alignof(std::max_align_t) );

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

Parameters
	nbytes	  - the number of bytes to allocate
	alignment - the alignment to use

Return value
	A pointer to the allocated storage.

Notes
	This  function was introduced for use with the fully-specialized alloca-
     tor
	std::pmr::polymorphic_allocator<>, but it may be useful in any	special-
     ization.

	The return type is void* (rather than, e.g., std::byte*) to support con-
     version to an
	arbitrary pointer type U* by static_cast<U*>.

Exceptions
	May throw any exceptions thrown by the call to resource()->allocate.

See also
	allocate_object allocates raw memory suitable for an object or an array
	(C++20) 	(public member function)
	new_object	allocates and constructs an object
	(C++20) 	(public member function)
	allocate	allocate memory
			(public member function)
	allocate	allocates uninitialized storage using the allocator
	[static]	  (public   static   member   function	of  std::alloca-
     tor_traits<Alloc>)

	allocate	allocates memory
			(public member function of std::pmr::memory_resource)

http://cppreference.com 	   2024.06.10	   std::pmr::p...locate_bytes(3)

home | help