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

FreeBSD Manual Pages

  
 
  

home | help
std::alloca...onstruction(3)  C++ Standard Libary std::alloca...onstruction(3)

NAME
       std::allocator_traits::select_on_container_copy_construction - std::al-
       locator_traits::select_on_container_copy_construction

Synopsis
	  Defined in header <memory>
	  static  Alloc	 select_on_container_copy_construction(	const Alloc& a
       );  (since C++11)
										 (un-
       til C++20)
	  static constexpr Alloc select_on_container_copy_construction(	 const
       (since C++20)
	  Alloc& a );

	  If  possible,	 obtains the copy-constructed version of the allocator
       a, by calling
	  a.select_on_container_copy_construction(). If	the above is not  pos-
       sible (e.g. Alloc
	  does not have	the member function select_on_container_copy_construc-
       tion()),	then
	  returns a, unmodified.

	  This function	is called by the copy constructors of all standard li-
       brary containers.
	  It allows the	allocator used by the constructor's argument to	become
       aware that the
	  container is being copied and	modify state if	necessary.

Parameters
	  a  - allocator used by a standard container passed as	an argument to
       a container copy
	      constructor

Return value
	  The allocator	to use by the copy-constructed standard	containers.

See also
					     copies the	state of  scoped_allo-
       cator_adaptor and all its select_on_container_copy_construction alloca-
       tors
					     (public member function of
					     std::scoped_allocator_adap-
       tor<OuterAlloc,InnerAlloc...>)

http://cppreference.com		  2022.07.31	  std::alloca...onstruction(3)

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

home | help