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

FreeBSD Manual Pages

  
 
  

home | help
std::flat_m...set::emplace(3) C++ Standard Libarystd::flat_m...set::emplace(3)

NAME
       std::flat_multiset::emplace - std::flat_multiset::emplace

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

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

	  First, initializes an	object t of  type  value_type  with  std::for-
       ward<Args>(args)...,
	  then inserts t as if by

	auto it	= ranges::upper_bound(c, t, compare);
	c.insert(it, std::move(t));

	  This overload	participates in	overload resolution only if
	  std::is_constructible_v<value_type, Args...> is true.

	  Careful  use	of  emplace  allows  the new element to	be constructed
       while avoiding
	  unnecessary copy or move operations.

	   Information on iterator invalidation	is copied from here

Parameters
	  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
	  Logarithmic 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
		       (public member function)
	  insert       inserts elements
		       (public member function)

Category:
	    * Todo no example

http://cppreference.com		  2024.06.10	 std::flat_m...set::emplace(3)

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

home | help