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() ) 的字符串。

异常

若 pos > size ( ) 则抛出 std::out_of_range 异常。

若因任何原因抛出异常，这些函数将不产生任何效果（ 强异常安全保证 ）。

复杂度

在 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++标准。

参阅