home | help 
std::flat_m...set::extract(3)  C++ Standard Libary std::flat_m...set::extract(3)

NAME
     std::flat_multiset::extract - std::flat_multiset::extract

Synopsis
	container_type extract() &&;  (since C++23)

	Extracts adapted container c. Equivalent to return std::move(c);.

	After this operation *this is empty, even if an exception is thrown.

Parameters
	(none)

Return value
	std::move(c).

Complexity
	Constant.

Example
     // Run this code

      #include <cassert>
      #include <flat_set>
      #include <print>
      #include <type_traits>
      #include <vector>

      int main()
      {
	  std::flat_multiset<int> set{1, 2, 3};
	  const auto size = set.size();

	  auto c = set.extract();
	  assert(c.size() == size);
	  assert(set.empty());
	  assert(set.keys().empty());
	  assert(set.values().empty());

	  // The default keys container is std::vector:
	  static_assert(std::is_same_v<decltype(c), std::vector<int>>);

	  std::println("{}", c);
      }

Output:
      [1, 2, 3]

See also
	replace replaces the underlying container
		(public member function)

http://cppreference.com 	   2024.06.10	   std::flat_m...set::extract(3)
home | help