Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
       std::pmr::polymorphic_allocator::allocate_bytes	 -  std::pmr::polymor-
       phic_allocator::allocate_bytes

Synopsis
	  [[nodiscard]]	 void*	allocate_bytes(	 std::size_t  nbytes,	(since
       C++20)
	  std::size_t alignment	= 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 al-
       locator
	  std::pmr::polymorphic_allocator<>, but it may	be useful in any  spe-
       cialization.

	  The  return type is void* (rather than, e.g.,	std::byte*) to support
       conversion 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_re-
       source)

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

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::pmr::polymorphic_allocator::allocate_bytes&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help