FreeBSD Manual Pages
std::flat_set::emplace(3) C++ Standard Libary std::flat_set::emplace(3) NAME std::flat_set::emplace - std::flat_set::emplace Synopsis template< class... Args > (since C++23) std::pair<iterator, bool> emplace( Args&&... args ); Inserts a new element into the container constructed in-place with the given args, if there is no element with the key in the container. 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 A pair consisting of an iterator to the inserted element (or to the element that prevented the insertion) and a bool value set to true if and only if the insertion took place. 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_set::emplace(3)
NAME | Synopsis | Parameters | Return value | Exceptions | Complexity | Example | See also | Category:
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::flat_set::emplace&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>