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

 

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_set

成員型別

成員函式

flat_set::flat_set flat_set::operator= 迭代器 flat_set::beginflat_set::cbegin flat_set::endflat_set::cend flat_set::rbeginflat_set::crbegin flat_set::rendflat_set::crend 容量 flat_set::size flat_set::max_size flat_set::empty 觀察器 flat_set::key_comp flat_set::value_comp      修改器 flat_set::clear flat_set::insert flat_set::insert_range flat_set::emplace flat_set::emplace_hint flat_set::erase flat_set::swap flat_set::extract flat_set::replace 查詢 flat_set::count flat_set::find flat_set::contains flat_set::equal_range flat_set::lower_bound flat_set::upper_bound 非成員函式 operator==operator<=> swap(std::flat_set) erase_if(std::flat_set)

輔助類

uses_allocator<std::flat_set>

標籤

sorted_unique      sorted_unique_t

推導指引

 

std::pair<iterator, bool> insert( const value_type& value );	(1)	(C++23 起)
std::pair<iterator, bool> insert( value_type&& value );	(2)	(C++23 起)
iterator insert( const_iterator pos, const value_type& value );	(3)	(C++23 起)
iterator insert( const_iterator pos, value_type&& value );	(4)	(C++23 起)
template< class K > iterator insert( const_iterator pos, K&& x );	(5)	(C++23 起)
template< class InputIt > void insert( InputIt first, InputIt last );	(6)	(C++23 起)
template< class K > std::pair<iterator, bool> insert( K&& x );	(7)	(C++23 起)
template< class InputIt > void insert( std::sorted_unique_t, InputIt first, InputIt last );	(8)	(C++23 起)
void insert( std::initializer_list<key_type> ilist );	(9)	(C++23 起)
void insert( std::sorted_unique_t s, std::initializer_list<key_type> ilist );	(10)	(C++23 起)

如果容器中尚不包含具有等效鍵的元素，則將元素插入容器。

1) 插入 value。等效於 return emplace(value);。

2) 插入 value。等效於 return emplace(std::move(value));。

3) 將 value 插入到儘可能接近 pos 之前的某個位置。等效於 return emplace_hint(pos, value);。

4) 將 value 插入到儘可能接近 pos 之前的某個位置。等效於 return emplace_hint(pos, std::move(value));。

5,7) 如果 *this 已包含一個與 x 透明比較等效的元素，則不執行任何操作。否則，插入一個新元素，如同透過以下方式：

• (5) emplace(pos, std::forward<K>(x))（在儘可能接近 pos 之前的某個位置）；
• (7) emplace(std::forward<K>(x))。

從 x 到 key_type 的轉換必須構造一個物件 u，對於該物件，find(k) == find(u) 為 true。否則，行為是未定義的。

這些過載僅在以下情況下參與過載解析：

• 限定 id Compare::is_transparent 有效並表示一個型別，並且
• std::is_constructible_v<value_type, K> 為 true，

兩者一起允許在不構造 Key 例項的情況下呼叫此函式。

6) 等效於以下操作序列：

1. 插入範圍 [first, last) 中的元素，如同透過 c.insert(c.end(), first, last);。
2. 根據 compare 對新插入元素的範圍進行排序。
3. 將產生的已排序範圍與預先存在的元素的已排序範圍合併為單個已排序範圍。（注意：合併操作可能會分配記憶體）。
4. 從每組連續等效元素中刪除除第一個元素之外的所有元素。

如果範圍中有多個元素具有比較等效的鍵，則插入哪個元素是未指定的（待定 LWG2844）。

8) 插入範圍 [first, last) 中的元素。等效於 insert(first, last);。

如果範圍中有多個元素具有比較等效的鍵，則插入哪個元素是未指定的（待定 LWG2844）。

9) 插入初始化列表 ilist 中的元素。等效於 insert(ilist.begin(), ilist.end());。

如果範圍中有多個元素具有比較等效的鍵，則插入哪個元素是未指定的（待定 LWG2844）。

10) 插入初始化列表 ilist 中的元素。等效於 insert(s, ilist.begin(), ilist.end());。

如果範圍中有多個元素具有比較等效的鍵，則插入哪個元素是未指定的（待定 LWG2844）。

引數

pos	-	指向新元素將插入位置之前的迭代器
value	-	要插入的元素值
first, last	-	定義要插入的元素源範圍的迭代器對
ilist	-	要從中插入值的初始化列表
x	-	可與鍵透明比較的任何型別的值
s	-	一個 消歧標記，指示輸入序列已排序（相對於 compare）並且只包含唯一元素
型別要求
- InputIt 必須滿足 LegacyInputIterator 的要求。

返回值

1,2) 一個對，由指向插入元素的迭代器（或阻止插入的元素）和一個布林值組成，該布林值僅當插入發生時設定為 true。

3-5) 指向插入元素或阻止插入的元素的迭代器。

6) (無)

7) 一個對，由指向插入元素的迭代器（或阻止插入的元素）和一個布林值組成，該布林值僅當插入發生時設定為 true。

8-10) (無)

異常

1-5,7) 如果任何操作丟擲異常，則插入無效。

複雜度

1-5) size() 的線性複雜度。

6) N + M·log(M)，其中 N 是操作前的 size()，M 是 std::distance(first, last)。

7) size() 的線性複雜度。

8) N 的線性複雜度，其中 N 是操作後的 size()。

9) N + M·log(M)，其中 N 是操作前的 size()，M 是 ilist.size()。

10) N 的線性複雜度，其中 N 是操作後的 size()。

注意

帶提示的插入 (3-5) 不返回布林值，以與順序容器（如 std::vector::insert）上的位置插入簽名相容。這使得可以建立泛型插入器，如 std::inserter。檢查帶提示的插入是否成功的一種方法是比較插入前後的 size()。

示例

執行此程式碼

#include <cassert>
#include <flat_set>
#include <iostream>
 
int main()
{
    std::flat_set<int> set;
 
    auto result_1 = set.insert(3);
    assert(result_1.first != set.end()); // it is a valid iterator
    assert(*result_1.first == 3);
    if (result_1.second)
        std::cout << "insert done\n";
 
    auto result_2 = set.insert(3);
    assert(result_2.first == result_1.first); // the same iterator
    assert(*result_2.first == 3);
    if (!result_2.second)
        std::cout << "no insertion\n";
}

輸出

insert done
no insertion

另見

emplace	就地構造元素 (公共成員函式)
emplace_hint	使用提示就地構造元素 (公共成員函式)
inserter	建立從引數推斷型別的std::insert_iterator (函式模板)