std::multiset<Key,Compare,Allocator>::insert

出自cppreference.com
 
C++
 
容器庫
 
std::multiset
成員函數
非成員函數
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)
推導指引(C++17)
 
iterator insert( const value_type& value );
(1) 
iterator insert( value_type&& value );
(2) (C++11 起) 
iterator insert( iterator pos, const value_type& value );
(3) (C++11 前) 
iterator insert( const_iterator pos, const value_type& value );
(C++11 起) 
iterator insert( const_iterator pos, value_type&& value );
(4) (C++11 起) 
template< class InputIt >
void insert( InputIt first, InputIt last );
(5) 
void insert( std::initializer_list<value_type> ilist );
(6) (C++11 起) 
iterator insert( node_type&& nh );
(7) (C++17 起) 
iterator insert( const_iterator pos, node_type&& nh );
(8) (C++17 起)

插入元素到容器。保留等價元素的順序。

1,2) 插入 value。如果容器擁有帶等價鍵的元素，那麼插入到範圍上界。
3,4) 將 value 插入到儘可能接近正好在 pos 之前的位置。
5) 插入來自範圍 [first, last) 的元素。
6) 插入來自 initializer_list ilist 的元素。
7) 如果 nh 是空的節點句柄，那麼什麼都不做。否則插入 nh 所擁有的元素到容器並返回指向被插入元素的迭代器。如果容器中存在一個範圍，其鍵均等價於 nh.key()，那麼元素被插入到此範圍的末尾。如果 nh 非空且 get_allocator() != nh.get_allocator()，那麼行為未定義。
8) 如果 nh 是空的節點句柄，那麼什麼都不做並返回尾迭代器。否則，插入 nh 所擁有的元素到容器，並返回指向擁有等於 nh.key() 的鍵的元素的迭代器。元素被插入到儘可能接近正好在 pos 之前的位置。如果 nh 非空且 get_allocator() != nh.get_allocator()，那麼行為未定義。

沒有迭代器或引用會失效。如果插入成功，在元素被節點句柄持有時所獲取的指向元素的指針或引用均會失效，而在元素被提取之前所獲取的指向它指針和引用則變為有效。(C++17 起)

參數

pos - 指向新元素將被插入位置之前的迭代器
value - 要插入的元素值
first, last - 要插入的源元素範圍的迭代器對
ilist - 插入值來源的 initializer_list
nh - 兼容的結點句柄
類型要求
-
InputIt 必須滿足老式輸入迭代器 (LegacyInputIterator) 。

返回值

1-4) 指向被插入元素的迭代器。
5,6) （無）
7,8) 如果 nh 為空就是尾迭代器，否則是指向被插入元素的迭代器。

異常

1-4,7,8) 如果任何操作拋出異常，那麼插入無效果。
5,6) 無異常安全保證。

複雜度

1,2,7) O(log(size()))
3,4,8) 如果正好在 pos 的前一個位置插入，那麼是均攤常數，否則是 O(log(size()))。
5,6) O(N·log(size() + N))，其中 N 是要插入的元素數。

示例

本節未完成
原因：暫無示例

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告 應用於 出版時的行為 正確行為
LWG 233 C++98 pos 只是提示，可以完全忽略 必須在儘可能接近正好在
pos 之前的位置插入
LWG 264 C++98 重載 (5) 的複雜度在範圍 [i, j) 已經按 Compare 排序的情況下要求是線性 取消這種情況下的線性複雜度要求
LWG 371 C++98 等價元素不一定會保留順序 要求保留

參閱

(C++11)
 原位構造元素
(公開成員函數) [編輯]
(C++11)
 使用提示原位構造元素
(公開成員函數) [編輯]
創建擁有從實參推出的類型的 std::insert_iterator
(函數模板) [編輯]