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

FreeBSD Manual Pages

  
 
  

home | help
std::unorde...et::emplace(3)  C++ Standard Libary std::unorde...et::emplace(3)

NAME
       std::unordered_multiset::emplace	- std::unordered_multiset::emplace

Synopsis
	  template< class... Args >	       (since C++11)
	  iterator emplace( Args&&... args );

	  Inserts  a  new element into the container constructed in-place with
       the given args .

	  Careful use of emplace allows	the  new  element  to  be  constructed
       while avoiding
	  unnecessary copy or move operations. The constructor of the new ele-
       ment is called
	  with	exactly	 the  same arguments as	supplied to emplace, forwarded
       via
	  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
	  args - arguments to forward to the constructor of the	element

Return value
	  Returns an iterator to the 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.

Example
	   This	section	is incomplete
	   Reason: no example

See also
	  emplace_hint constructs elements in-place using a hint
	  (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...et::emplace(3)

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

home | help