最終更新日時: 2026年03月21日 23時12分53秒 (JST)
Raclamusi が更新

履歴 編集

function
<forward_list>

# std::forward_list::assign(C++11)

    template <class InputIterator>
    void assign(InputIterator first, InputIterator last);           // (1) C++11
    template <class InputIterator>
    constexpr void assign(InputIterator first, InputIterator last); // (1) C++26

    void assign(size_type n, const T& t);           // (2) C++11
    constexpr void assign(size_type n, const T& t); // (2) C++26

    void assign(initializer_list<T> init);           // (3) C++11
    constexpr void assign(initializer_list<T> init); // (3) C++26

## 概要

コンテナの再代入

- (1) : イテレータ範囲を代入
- (2) : `n`個の値`t`を代入
- (3) : 初期化子リストを代入

## 効果

- (1) :

    clear();
    insert_after(before_begin(), first, last);

- (2) :

    clear();
    insert_after(before_begin(), n, t);

- (3) : 以下と等価

    assign(init.begin(), init.end());

## 戻り値

なし

## 例

    #include <iostream>
    #include <forward_list>
    #include <string>

    template <class T>
    void print(const std::string& name, const std::forward_list<T>& ls)
    {
      std::cout << name << " : ";
      for (const T& x : ls) {
        std::cout << x << ' ';
      }
      std::cout << std::endl;
    }

    int main()
    {
      // 範囲を代入
      {
        std::forward_list<int> ls = {1, 2, 3};
        std::forward_list<int> ls1;
        ls1.assign(ls.begin(), ls.end());

        ::print("ls1", ls1);
      }

      // n個の指定された値で埋める
      {
        std::forward_list<int> ls2;
        ls2.assign(3, 1);

        ::print("ls2", ls2);
      }

      // 初期化子リストを代入
      {
        std::forward_list<int> ls3;
        ls3.assign({1, 2, 3});

        ::print("ls3", ls3);
      }
    }

### 出力

    ls1 : 1 2 3
    ls2 : 1 1 1
    ls3 : 1 2 3

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2010 ✅, 2012 ✅, 2013 ✅, 2015 ✅, 2017 ✅
  - (3) `initializer_list`のオーバーロードは2013から。

## 参照

- N2679 Initializer Lists for Standard Containers(Revision 1)
  - (3)の経緯となる提案文書
- P3372R3 constexpr containers and adaptors