Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::flat_set<Key,Compare,KeyContainer>::extract

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

NotebookLM
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

example.cpp
#include <cassert>
#include <flat_set>
#include <print>
#include <type_traits>
#include <vector>
 
int main()
{
    std::flat_set<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

replaces the underlying container
(public member function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.