std::basic_string<CharT,Traits,Allocator>:: insert_range

rg で指定された範囲の文字を、 pos が指す要素（存在する場合）の前に挿入します。

次と同等

return insert(pos - begin(),
    std::basic_string(
        std::from_range,
        std​::​forward<R>(rg),
        get_allocator())
);

pos が * this に対する有効なイテレータでない場合、動作は未定義です。

パラメータ

戻り値

最初に挿入された文字を参照するイテレータ、または pos （ rg が空だったために文字が挿入されなかった場合）。

計算量

rg のサイズに対して線形。

例外

std:: allocator_traits < Allocator > :: allocate が例外をスローした場合、その例外は再スローされます。

操作によって size() が max_size() を超える場合、 std::length_error をスローします。

何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません（ strong exception safety guarantee ）。

注記

例

#include <cassert>
#include <iterator>
#include <string>
int main()
{
    const auto source = {'l', 'i', 'b', '_'};
    std::string target{"__cpp_containers_ranges"};
    //                        ^挿入はこの位置の前で発生
    //                         この位置の前で挿入が行われる
    const auto pos = target.find("container");
    assert(pos != target.npos);
    auto iter = std::next(target.begin(), pos);
#ifdef __cpp_lib_containers_ranges
    target.insert_range(iter, source);
#else
    target.insert(iter, source.begin(), source.end());
#endif
    assert(target == "__cpp_lib_containers_ranges");
    //                      ^^^^
}

関連項目