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

basic_string substr( size_type pos = 0, size_type count = npos ) const;

constexpr basic_string
    substr( size_type pos = 0, size_type count = npos ) const&;

constexpr basic_string substr( size_type pos = 0, size_type count = npos ) &&;

部分文字列 [pos, pos + count) を返します。要求された部分文字列が文字列の終端を超える場合、すなわち count が size() - pos より大きい場合（例えば count == npos の場合）、返される部分文字列は [pos, size()) です。

パラメータ

戻り値

部分文字列を含む文字列 [ pos , pos + count ) または [ pos , size() ) の範囲。

例外

std::out_of_range posが pos > size ( ) の場合。

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

計算量

count に対して線形。

注記

返される文字列のアロケータはデフォルト構築されます：新しいアロケータは 必ずしも get_allocator() のコピーであるとは限りません。

例

#include <iostream>
#include <string>
int main()
{
    std::string a = "0123456789abcdefghij";
    // countがnposの場合、[pos, size())を返す
    std::string sub1 = a.substr(10);
    std::cout << sub1 << '\n';
    // posとpos + countの両方が範囲内の場合、[pos, pos + count)を返す
    std::string sub2 = a.substr(5, 3);
    std::cout << sub2 << '\n';
    // posが範囲内でpos + countが範囲外の場合、[pos, size())を返す
    std::string sub4 = a.substr(a.size() - 3, 50);
    // これは事実上以下と同等
    // std::string sub4 = a.substr(17, 3);
    // a.size() == 20, pos == a.size() - 3 == 17, a.size() - pos == 3 のため
    std::cout << sub4 << '\n';
    try
    {
        // posが範囲外の場合、例外をスロー
        std::string sub5 = a.substr(a.size() + 3, 50);
        std::cout << sub5 << '\n';
    }
    catch (const std::out_of_range& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

abcdefghij
567
hij
basic_string::substr: __pos (which is 23) > this->size() (which is 20)

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目