flat_multimap_extract

flat_multimap_extract (std::flat_multimap::extract — 내부 컨테이너 추출)

std::flat_multimap이 내부적으로 쓰는 적응 컨테이너(키 컨테이너와 매핑값 컨테이너)를 꺼내서 반환하는 멤버 함수예요. std::move(c)를 반환하는 것과 동등하며, 이 연산 후에는 예외가 던져져도 *this는 비어 있게 돼요.

출처: cppreference

본문

시그니처는 다음과 같아요.

containers extract() &&;   // (since C++23)

적응 컨테이너 *c*를 추출해요. return std::move(c);와 동등해요. 이 연산 후 *this는 비어 있어요(예외가 던져지는 경우에도 마찬가지예요).

반환값

std::move(c).

복잡도

상수(constant)예요.

예제

#include <cassert>
#include <flat_map>
#include <print>
#include <type_traits>
#include <utility>
#include <vector>
int main()
{
    std::flat_multimap<int, double> map{{1, 1.1}, {2, 2.2}, {3, 3.3}};
    const auto size{map.size()};
    auto c{std::move(map).extract()};
    assert(c.keys.size() == size);
    assert(c.values.size() == size);
    assert(map.empty());
    assert(map.keys().empty());
    assert(map.values().empty());
    // 기본 키/값 컨테이너는 std::vector예요:
    static_assert(std::is_same_v<decltype(c.keys), std::vector<int>>);
    static_assert(std::is_same_v<decltype(c.values), std::vector<double>>);
    std::println("keys: {}", c.keys);
    std::println("values: {}", c.values);
}

출력:

keys: [1, 2, 3]
values: [1.1, 2.2, 3.3]

함께 보기

  • replace: 내부 컨테이너를 교체해요 (공개 멤버 함수)

더 알아보기 (Learn more)

cppreference