最終更新日時:
が更新

履歴 編集

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

iterator insert(const_iterator position, T&& x);                  // (2) C++11

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

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

iterator insert(const_iterator position, initializer_list<T> il); // (5) C++11

概要

任意の位置に新たな要素を挿入する

要件

戻り値

挿入された要素を指すイテレータ

計算量

挿入される要素の数と挿入される要素の位置とend()の間の要素数に対して線形時間の計算量が必要である。

備考

  • 要素を追加した後のsize()が要素を追加する前のcapacity()よりも大きい場合は領域の再確保が生じる。領域の再確保が生じなかった場合には挿入位置より前のイテレーターや参照は有効である。
  • 条件付きで、例外が発生した場合に副作用が発生しない保証がある。
    • C++03: 要素型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

バージョン

言語

参照