insert_range.md

insert_range

• vector[meta header]
• std[meta namespace]
• vector[meta class]
• function template[meta id-type]
• cpp23[meta cpp]

template <container-compatible-range<T> R>
constexpr iterator insert_range(const_iterator pos, R&& rg); // C++23

概要

Rangeの各要素を任意の位置に挿入する。

テンプレートパラメータ制約

型Tが*ranges::begin(rg)からvectorコンテナへのEmplaceConstructibleであり、かつ型TがMoveConstructible・MoveAssignable・Swappableであること。

効果

Rangergの各要素を、posの直前に挿入する。

戻り値

挿入されたRangergの最初の要素を指すイテレータ。rgが空の場合はpos。

例

#include <iostream>
#include <iterator>
#include <vector>

int main()
{
  std::vector<int> v = {1, 2, 3};
  const int a[3] = {4, 5, 6};

  // Rangeを１番目と２番目の要素の間に挿入
  v.insert_range(std::next(v.begin()), a);

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

• insert_range[color ff0000]

出力

1 4 5 6 2 3 

関連項目

名前	説明
insert	要素の挿入
emplace	要素の直接構築による挿入