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	into the container, using hint as a suggestion
       where the
	  element should go.

	  The constructors of the key and mapped value are called with exactly
       the same
	  arguments  as	 supplied  to  the  function, forwarded	with std::for-
       ward<Args>(args)....

	  If after the operation the new number	of elements  is	 greater  than
       old
	  max_load_factor() * bucket_count() a rehashing takes place.
	  If rehashing occurs (due to the insertion), all iterators are	inval-
       idated. Otherwise
	  (no rehashing), iterators are	not invalidated.

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
	  An iterator to the inserted element.

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

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

Example
	   This	section	is incomplete
	   Reason: no example

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

Category:
	    * Todo no example

http://cppreference.com		  2024.06.10	 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.1.quarterly>

home | help