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

履歴 編集

function
<list>

# std::list::assign

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

    void assign(size_type n, const T& t);           // (2) C++03
    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(begin(), first, last);

- (2) :

    clear();
    insert(begin(), n, t);

- (3) :

    clear();
    insert(begin(), init.begin(), init.end());

## 戻り値

なし

## 例

    #include <iostream>
    #include <list>
    #include <string>

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

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

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

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

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

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

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

### 出力

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

## 参照

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