• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

    最終更新日時(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
    

    バージョン

    言語

    参照