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

NAME
     std::allocator_traits::select_on_container_copy_construction - std::alloca-
     tor_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 possible
     (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 library
     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_alloca-
     tor_adaptor and all its
					   allocators		  select_on_con-
     tainer_copy_construction (public member function of
					   std::scoped_allocator_adaptor<Outer-
     Alloc,InnerAlloc...>)

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

home | help