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

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

メンバ関数 basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator 要素アクセス basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) イテレータ basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

操作 basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap 検索 basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of 定数 basic_string::npos

非メンバ関数 operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) 入出力 operator<<operator>> getline 比較 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20) 数値変換 (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring ヘルパークラス hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) 推定ガイド(C++17)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

(1)

basic_string& insert( size_type index, size_type count, CharT ch );

(C++20未満)

constexpr basic_string& insert( size_type index, size_type count, CharT ch );

(C++20以上)

(2)

basic_string& insert( size_type index, const CharT* s );

(C++20未満)

constexpr basic_string& insert( size_type index, const CharT* s );

(C++20以上)

(3)

basic_string& insert( size_type index, const CharT* s, size_type count );

(C++20未満)

constexpr basic_string& insert( size_type index, const CharT* s, size_type count );

(C++20以上)

(4)

basic_string& insert( size_type index, const basic_string& str );

(C++20未満)

constexpr basic_string& insert( size_type index, const basic_string& str );

(C++20以上)

(5)

basic_string& insert( size_type index, const basic_string& str, size_type index_str, size_type count );

(C++14未満)

basic_string& insert( size_type index, const basic_string& str, size_type index_str, size_type count = npos);

(C++14以上) (C++20未満)

constexpr basic_string& insert( size_type index, const basic_string& str, size_type index_str, size_type count = npos);

(C++20以上)

(6)

iterator insert( iterator pos, CharT ch );

(C++11未満)

iterator insert( const_iterator pos, CharT ch );

(C++11以上) (C++20未満)

constexpr iterator insert( const_iterator pos, CharT ch );

(C++20以上)

(7)

void insert( iterator pos, size_type count, CharT ch );

(C++11未満)

iterator insert( const_iterator pos, size_type count, CharT ch );

(C++11以上) (C++20未満)

constexpr iterator insert( const_iterator pos, size_type count, CharT ch );

(C++20以上)

(8)

template< class InputIt > void insert( iterator pos, InputIt first, InputIt last );

(C++11未満)

template< class InputIt > iterator insert( const_iterator pos, InputIt first, InputIt last );

(C++11以上) (C++20未満)

template< class InputIt > constexpr iterator insert( const_iterator pos, InputIt first, InputIt last );

(C++20以上)

(9)

iterator insert( const_iterator pos, std::initializer_list<CharT> ilist );

(C++11以上) (C++20未満)

constexpr iterator insert( const_iterator pos, std::initializer_list<CharT> ilist );

(C++20以上)

(10)

template < class T > basic_string& insert( size_type pos, const T& t );

(C++17以上) (C++20未満)

template < class T > constexpr basic_string& insert( size_type pos, const T& t );

(C++20以上)

(11)

template < class T > basic_string& insert( size_type index, const T& t, size_type index_str, size_type count = npos);

(C++17以上) (C++20未満)

template < class T > constexpr basic_string& insert( size_type index, const T& t, size_type index_str, size_type count = npos);

(C++20以上)

See More

文字列に文字を挿入します。

1) 位置 index に文字 ch のコピーを count 個挿入します。

2) 位置 index に s の指すヌル終端文字列を挿入します。 文字列の長さは Traits::length(s) を用いて最初のヌル文字によって決定されます。

3) 範囲 [s, s+count) の文字を位置 index に挿入します。 範囲はヌル文字を含むことができます。

4) 位置 index に文字列 str を挿入します。

5) 位置 index に str.substr(index_str, count) から取得した文字列を挿入します。

6) pos の指す文字の前に文字 ch を挿入します。

7) pos の指す要素 (もしあれば) の前に文字 ch のコピーを count 個挿入します。

8) pos の指す要素 (もしあれば) の前に範囲 [first, last) から文字を挿入します。 このオーバーロードは、 InputIt が LegacyInputIterator を満たさない場合、オーバーロード解決に参加しません。 (C++11以上)

9) pos の指す要素 (もしあれば) の前に初期化子リスト ilist から要素を挿入します。

10) std::basic_string_view<CharT, Traits> sv = t; によって行われたかのように、 t を文字列ビュー sv に暗黙に変換し、 insert(pos, sv.data(), sv.size()) によって行われたかのように、 pos の指す要素 (もしあれば) の前に sv から要素を挿入します。 このオーバーロードは、std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> が true であり、 std::is_convertible_v<const T&, const CharT*> が false である場合にのみ、オーバーロード解決に参加します。

11) std::basic_string_view<CharT, Traits> sv = t; によって行われたかのように、 t を文字列ビュー sv に暗黙に変換し、 pos の指す要素 (もしあれば) の前に sv のサブビュー [index_str, index_str+count) から文字を挿入します。 要求されたサブビューが終端を超える場合、または count == npos の場合、結果のサブビューは [index_str, sv.size())になります。 index_str > sv.size() の場合、または index > size() の場合、 std::out_of_range が投げられます。 このオーバーロードは、std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> が true であり、 std::is_convertible_v<const T&, const CharT*> が false である場合にのみ、オーバーロード解決に参加します。

引数

index	-	内容を挿入する位置
pos	-	前に文字を挿入するイテレータ
ch	-	挿入する文字
count	-	挿入する文字数
s	-	挿入する文字列を指すポインタ
str	-	挿入する文字列
first, last	-	挿入する文字列を定義する範囲
index_str	-	挿入する文字列 str 内の最初の文字の位置
ilist	-	挿入する文字の std::initializer_list
t	-	挿入する文字の (std::basic_string_view に変換可能な) オブジェクト
型の要件
- InputIt は LegacyInputIterator の要件を満たさなければなりません。

戻り値

1-5,10-11) *this。

6-9) 挿入された最初の文字のコピーを参照するイテレータ、または挿入された文字がなかった (count==0 または first==last または ilist.size()==0) 場合は pos。

例外

1-4, 10) index > size() の場合は std::out_of_range を投げます。

5) index > size() の場合または index_str > str.size() の場合は std::out_of_range を投げます。

11) index > size() の場合または index_str > sv.size() の場合は std::out_of_range を投げます。

すべてのケースにおいて、 size() + ins_count > max_size() の場合は std::length_error を投げます。 ただし ins_count は挿入される文字数です。 また、 Allocator::allocate によって投げられるあらゆる例外を投げる可能性があります。

いずれのケースでも、何らかの理由で例外が投げられた場合、この関数は効果を持ちません (強い例外保証)。

(C++11以上)

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

DR	適用先	発行時の動作	正しい動作
LWG 2946	C++17	string_view overload causes ambiguity in some cases	avoided by making it a template

例

Run this code

#include <cassert>
#include <iterator>
#include <string>
using namespace std::string_literals;
int main()
{
    std::string s = "xmplr";

    // insert(size_type index, size_type count, char ch)
    s.insert(0, 1, 'E');
    assert("Exmplr" == s);

    // insert(size_type index, const char* s)
    s.insert(2, "e");
    assert("Exemplr" == s);

    // insert(size_type index, string const& str)
    s.insert(6, "a"s);
    assert("Exemplar" == s);

    // insert(size_type index, string const& str,
    //     size_type index_str, size_type count)
    s.insert(8, " is an example string."s, 0, 14);
    assert("Exemplar is an example" == s);

    // insert(const_iterator pos, char ch)
    s.insert(s.cbegin() + s.find_first_of('n') + 1, ':');
    assert("Exemplar is an: example" == s);

    // insert(const_iterator pos, size_type count, char ch)
    s.insert(s.cbegin() + s.find_first_of(':') + 1, 2, '=');
    assert("Exemplar is an:== example" == s);

    // insert(const_iterator pos, InputIt first, InputIt last)
    {
        std::string seq = " string";
        s.insert(s.begin() + s.find_last_of('e') + 1,
            std::begin(seq), std::end(seq));
        assert("Exemplar is an:== example string" == s);
    }

    // insert(const_iterator pos, std::initializer_list<char>)
    s.insert(s.cbegin() + s.find_first_of('g') + 1, { '.' });
    assert("Exemplar is an:== example string." == s);
}

関連項目

append	文字を末尾に追加します (パブリックメンバ関数)
push_back	文字を末尾に追加します (パブリックメンバ関数)