std::flat_map 的推導指南

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

容器庫

序列

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

關聯

set

multiset

map

multimap

無序關聯

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

介面卡

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

檢視

span (C++20)

mdspan (C++23)

表格

迭代器失效

成員函式表格

非成員函式表格

 

std::flat_map

成員型別

成員函式

flat_map::flat_map flat_map::operator= 元素訪問 flat_map::at flat_map::operator[] 迭代器 flat_map::beginflat_map::cbegin flat_map::endflat_map::cend flat_map::rbeginflat_map::crbegin flat_map::rendflat_map::crend 查詢 flat_map::count flat_map::find flat_map::contains flat_map::equal_range    flat_map::lower_bound flat_map::upper_bound 容量 flat_map::size flat_map::max_size flat_map::empty 修改器 flat_map::clear flat_map::erase flat_map::swap flat_map::emplace flat_map::extract flat_map::replace flat_map::insert flat_map::insert_range flat_map::insert_or_assign flat_map::emplace_hint flat_map::try_emplace 觀察器 flat_map::key_comp flat_map::keys flat_map::value_comp flat_map::values

非成員函式

operator==operator<=>         swap(std::flat_map) erase_if(std::flat_map)

輔助類

uses_allocator<std::flat_map>

標籤

sorted_unique       sorted_unique_t

推導指引

 

在標頭檔案 <flat_map> 中定義
template< class KeyContainer, class MappedContainer,           class Compare = std::less<typename KeyContainer::value_type> > flat_map( KeyContainer, MappedContainer, Compare = Compare() )     -> flat_map<typename KeyContainer::value_type,                 typename MappedContainer::value_type,                 Compare, KeyContainer, MappedContainer>;	(1)	(C++23 起)
template< class KeyContainer, class MappedContainer, class Allocator > flat_map( KeyContainer, MappedContainer, Allocator )     -> flat_map<typename KeyContainer::value_type,                 typename MappedContainer::value_type,                 std::less<typename KeyContainer::value_type>,                 KeyContainer, MappedContainer>;	(2)	(C++23 起)
template< class KeyContainer, class MappedContainer,           class Compare, class Allocator > flat_map( KeyContainer, MappedContainer, Compare, Allocator )     -> flat_map<typename KeyContainer::value_type,                 typename MappedContainer::value_type,                 Compare, KeyContainer, MappedContainer>;	(3)	(C++23 起)
template< class KeyContainer, class MappedContainer,           class Compare = std::less<typename KeyContainer::value_type> > flat_map( std::sorted_unique_t, KeyContainer, MappedContainer,           Compare = Compare() )     -> flat_map<typename KeyContainer::value_type,                 typename MappedContainer::value_type,                 Compare, KeyContainer, MappedContainer>;	(4)	(C++23 起)
template< class KeyContainer, class MappedContainer, class Allocator > flat_map( std::sorted_unique_t, KeyContainer, MappedContainer,           Allocator )     -> flat_map<typename KeyContainer::value_type,                 typename MappedContainer::value_type,                 std::less<typename KeyContainer::value_type>,                 KeyContainer, MappedContainer>;	(5)	(C++23 起)
template< class KeyContainer, class MappedContainer,           class Compare, class Allocator> flat_map( std::sorted_unique_t, KeyContainer, MappedContainer,           Compare, Allocator )     -> flat_map<typename KeyContainer::value_type,                 typename MappedContainer::value_type,                 Compare, KeyContainer, MappedContainer>;	(6)	(C++23 起)
template< class InputIter,           class Compare = std::less</*iter-key-type*/<InputIter>> > flat_map( InputIter, InputIter, Compare = Compare() )     -> flat_map</*iter-key-type*/<InputIter>,                 /*iter-mapped-type*/<InputIter>, Compare>;	(7)	(C++23 起)
template< class InputIter,           class Compare = std::less</*iter-key-type*/<InputIter>> > flat_map( std::sorted_unique_t, InputIter, InputIter,           Compare = Compare() )     -> flat_map</*iter-key-type*/<InputIter>,                 /*iter-mapped-type*/<InputIter>, Compare>;	(8)	(C++23 起)
template< ranges::input_range R,           class Compare = std::less</*range-key-type*/<R>>,           class Allocator = allocator<byte> > flat_map( std::from_range_t, R&&, Compare = Compare(),           Allocator = Allocator() )     -> flat_map</*range-key-type*/<R>, /*range-mapped-type*/<R>, Compare,                 std::vector</*range-key-type*/<R>,                             /*alloc-rebind*/<Allocator,                                              /*range-key-type*/<R>>>,                 std::vector</*range-mapped-type*/<R>,                             /*alloc-rebind*/<Allocator,                                              /*range-mapped-type*/<R>>>>;	(9)	(C++23 起)
template< ranges::input_range R, class Allocator > flat_map( std::from_range_t, R&&, Allocator )     -> flat_map</*range-key-type*/<R>, /*range-mapped-type*/<R>,                 std::less</*range-key-type*/<R>>,                 std::vector</*range-key-type*/<R>,                             /*alloc-rebind*/<Allocator,                                              /*range-key-type*/<R>>>,                 std::vector</*range-mapped-type*/<R>,                             /*alloc-rebind*/<Allocator,                                              /*range-mapped-type*/<R>>>>;	(10)	(C++23 起)
template< class Key, class T, class Compare = std::less<Key> > flat_map( std::initializer_list<pair<Key, T>>, Compare = Compare() )     -> flat_map<Key, T, Compare>;	(11)	(C++23 起)
template< class Key, class T, class Compare = std::less<Key> > flat_map( std::sorted_unique_t, std::initializer_list<pair<Key, T>>,           Compare = Compare() )     -> flat_map<Key, T, Compare>;	(12)	(C++23 起)

為 提供了這些推導指南，以允許從以下情況進行推導：

1) 鍵容器、對映容器和比較器。

2) 鍵容器、對映容器和分配器。

3) 鍵容器、對映容器、比較器和分配器。

4) std::sorted_unique_t 標籤、鍵容器、對映容器和比較器。

5) std::sorted_unique_t 標籤、鍵容器、對映容器和分配器。

6) std::sorted_unique_t 標籤、鍵容器、對映容器、比較器和分配器。

7) 迭代器範圍和比較器。

8) std::sorted_unique_t 標籤、迭代器範圍和比較器。

9) std::from_range_t 標籤、input_range 範圍、比較器和分配器。

10) std::from_range_t 標籤、input_range 範圍和分配器。

11) std::initializer_list 和比較器。

12) std::sorted_unique_t 標籤、std::initializer_list 和比較器。

這些過載僅在 InputIt 滿足 LegacyInputIterator，Alloc 滿足 Allocator，並且 Comp 不滿足 Allocator 時參與過載決議。

注意：庫確定型別不滿足 LegacyInputIterator 的程度未指定，但至少整數型別不符合輸入迭代器。同樣，它確定型別不滿足 Allocator 的程度未指定，但至少成員型別 Alloc::value_type 必須存在，並且表示式 std::declval<Alloc&>().allocate(std::size_t{}) 在作為未求值運算元處理時必須是格式良好的。