GeezerVison is showing cpprefjp.github.io — std::vector::insert - cpprefjp C++日本語リファレンス
最終更新日時:
2026年09月11日 13時06分31秒 (JST)
Akira Takahashi
が更新
function
<vector>
std:: vector:: insert
iterator insert ( iterator position , const T & x ); // (1) C++98
iterator insert ( const_iterator position , const T & x ); // (1) C++11
constexpr iterator insert ( const_iterator position , const T & x ); // (1) C++20
iterator insert ( const_iterator position , T && x ); // (2) C++11
constexpr iterator insert ( const_iterator position , T && x ); // (2) C++20
void insert ( iterator position ,
size_type n , const T & x ); // (3) C++98
iterator insert ( const_iterator position ,
size_type n , const T & x ); // (3) C++11
constexpr iterator insert ( const_iterator position ,
size_type n , const T & x ); // (3) C++20
template < class InputIterator >
void insert ( iterator position ,
InputIterator first ,
InputIterator last ); // (4) C++98
template < class InputIterator >
iterator insert ( const_iterator position ,
InputIterator first ,
InputIterator last ); // (4) C++11
template < class InputIterator >
constexpr iterator insert ( const_iterator position ,
InputIterator first ,
InputIterator last ); // (4) C++20
iterator insert ( const_iterator position ,
initializer_list < T > il ); // (5) C++11
constexpr iterator insert ( const_iterator position ,
initializer_list < T > il ); // (5) C++20
概要
任意の位置に新たな要素を挿入する
テンプレートパラメータ制約
(1)
型Tが*thisのコンテナに対してコピー挿入可能であること
型Tがコピー代入可能 であること
(2)
型Tが*thisのコンテナに対してムーブ挿入可能であること
型Tがムーブ代入可能 であること
(3)
型Tが*thisのコンテナに対してコピー挿入可能であること
型Tがコピー代入可能 であること
戻り値
挿入された要素を指すイテレータ
計算量
挿入される要素の数と挿入される要素の位置とend()
備考
要素を追加した後のsize() capacity()
条件付きで、例外が発生した場合に副作用が発生しない保証がある。
C++98: 要素型Tのコピーコンストラクタ、代入演算子以外で例外が発生した場合、副作用は発生しない。
C++11: 要素型Tのコピーコンストラクタ、ムーブコンストラクタ、代入演算子、ムーブ代入演算子、またはInputIteratorの操作以外で例外が発生した場合、副作用は発生しない。（ムーブとInputIteratorの操作について規定が追加された。）
C++14: 単一要素を終端に追加する場合はpush_back()
例
基本的な使い方 (C++11)
#include <iostream>
#include <vector>
#include <string>
#include <algorithm>
int main ()
{
std::vector < std::string > v = { "aaa" , "bbb" , "ccc" };
// 挿入位置と、追加するconst&の要素を指定するバージョン
{
std::string s = "ddd" ;
v . insert ( v.begin() + 1 , s );
}
// 挿入位置と、追加する&&の要素を指定するバージョン
{
v . insert ( v.begin() + 1 , std::string ( "eee" ));
}
// 挿入位置とイテレータの範囲を指定するバージョン
{
std::vector < std::string > x = { "fff" , "ggg" };
v . insert ( v.begin() + 1 , x . begin (), x . end ());
}
// 挿入位置と初期化子リストを指定するバージョン
{
v . insert ( v.begin() + 1 , { "hhh" , "iii" });
}
std::for_each ( v.begin() , v.end() , []( decltype ( v ) :: const_reference x ) {
std::cout << x << std::endl ;
});
}
出力
aaa
hhh
iii
fff
ggg
eee
ddd
bbb
ccc
末尾への挿入 (C++11)
出力
1
2
3
4
5
6
7
8
9
バージョン
言語
C++11 :右辺参照バージョン
C++11 : 初期化子リストバージョン
参照