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

FreeBSD Manual Pages

  
 
  

home | help
std::unorde...emplace_hint(3) C++ Standard Libarystd::unorde...emplace_hint(3)

NAME
       std::unordered_multiset::emplace_hint   -  std::unordered_multiset::em-
       place_hint

Synopsis
	  template			 <class...			 Args>
       (since C++11)
	  iterator emplace_hint( const_iterator	hint, Args&&...	args );

	  Inserts  a  new element to the container, using hint as a suggestion
       where the element
	  should go. The element is constructed	in-place, i.e. no copy or move
       operations are
	  performed.

	  The constructor of the element is called with	exactly	the same argu-
       ments as	supplied
	  to the function, forwarded with std::forward<Args>(args)....

	  If rehashing occurs due to the insertion, all	iterators are  invali-
       dated. Otherwise
	  iterators  are not affected. References are not invalidated. Rehash-
       ing occurs only if
	  the  new  number  of	elements   is	greater	  than	 max_load_fac-
       tor()*bucket_count().

Parameters
	  hint	- iterator, used as a suggestion as to where to	insert the new
       element
	  args - arguments to forward to the constructor of the	element

Return value
	  Returns an iterator to the newly inserted element.

Exceptions
	  If an	exception is thrown by any operation, this function has	no ef-
       fect (strong
	  exception guarantee).

Complexity
	  Amortized constant on	average, worst case linear in the size of  the
       container.

See also
	  emplace constructs element in-place
	  (C++11) (public member function)
		  inserts elements
	  insert  or nodes
	  (C++11) (since C++17)
		  (public member function)

http://cppreference.com		  2022.07.31	 std::unorde...emplace_hint(3)

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

home | help