最終更新日時(UTC):
が更新

履歴 編集

function
<vector>

std::vector::insert

iterator insert(iterator position, const T& x);                 // (1) C++03
iterator insert(const_iterator position, const T& x);           // (1) C++11
consrexpr 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++03
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++03
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++03: 要素型Tのコピーコンストラクタ、代入演算子以外で例外が発生した場合、副作用は発生しない。
    • C++11: 要素型Tのコピーコンストラクタ、ムーブコンストラクタ、代入演算子、ムーブ代入演算子、またはInputIteratorの操作以外で例外が発生した場合、副作用は発生しない。(ムーブとInputIteratorの操作について規定が追加された。)
    • C++14: 単一要素を終端に追加する場合はpush_back()と同様。それ以外はC++11と同様。

基本的な使い方 (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)

#include <iostream>
#include <vector>
#include <list>

int main() {
  std::vector<int> v = {1, 2, 3};

  // 末尾の次を指すイテレータ (v.end()) 位置に挿入することで、
  // 末尾に要素が追加される
  v.insert(v.end(), {4, 5, 6});

  std::list<int> ls = {7, 8, 9};
  v.insert(v.end(), ls.begin(), ls.end());

  for (int x : v) {
    std::cout << x << std::endl;
  }
}

出力

1
2
3
4
5
6
7
8
9

バージョン

言語

参照