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

	(1)
basic_string substr( size_type pos = 0, size_type count = npos ) const;			(直到 C++23) (从 C++20 开始为 constexpr)
constexpr basic_string substr( size_type pos = 0, size_type count = npos ) const&;			(从 C++23 开始)
constexpr basic_string substr( size_type pos = 0, size_type count = npos ) &&;		(2)	(从 C++23 开始)

返回一个子字符串 [pos, pos + count)。如果请求的子字符串超过字符串的结尾，即 count 大于 size() - pos（例如，如果 count == npos），则返回的子字符串为 [pos, size())。

1) 等效于 return basic_string(*this, pos, count);.

2) 等效于 return basic_string(std::move(*this), pos, count);.

[编辑] 参数

pos	-	要包含的第一个字符的位置
count	-	子字符串的长度

[编辑] 返回值

包含子字符串 [pos, pos + count) 或 [pos, size()) 的字符串。

[编辑] 异常

std::out_of_range 如果 pos > size().

如果出于任何原因抛出异常，这些函数不会产生任何影响 (强异常安全保证).

[编辑] 复杂度

与 count 线性相关。

[编辑] 注释

返回字符串的分配器是默认构造的：新的分配器可能不是 get_allocator() 的副本。

[编辑] 示例

运行此代码

#include <iostream>
#include <string>
 
int main()
{
    std::string a = "0123456789abcdefghij";
 
    // count is npos, returns [pos, size())
    std::string sub1 = a.substr(10);
    std::cout << sub1 << '\n';
 
    // both pos and pos + count are within bounds, returns [pos, pos + count)
    std::string sub2 = a.substr(5, 3);
    std::cout << sub2 << '\n';
 
    // pos is within bounds, pos + count is not, returns [pos, size())
    std::string sub4 = a.substr(a.size() - 3, 50);
    // this is effectively equivalent to
    // std::string sub4 = a.substr(17, 3);
    // since a.size() == 20, pos == a.size() - 3 == 17, and a.size() - pos == 3
 
    std::cout << sub4 << '\n';
 
    try
    {
        // pos is out of bounds, throws
        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++ 标准。

DR	应用于	发布的行为	正确行为
LWG 847	C++98	没有异常安全保证	添加了强异常安全保证

[编辑] 另请参阅

copy	复制字符 (公共成员函数) [编辑]
sizelength	返回字符数 (公共成员函数) [编辑]
find	查找给定子字符串的第一次出现 (公共成员函数) [编辑]
npos [静态]	特殊值。确切的含义取决于上下文 (公共静态成员常量) [编辑]
substr	返回一个子字符串 (`std::basic_string_view<CharT,Traits>` 的公共成员函数) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

以空字符结尾的字符串
字节字符串
多字节字符串
宽字符串
类
basic_string
basic_string_view (C++17)
char_traits

cppreference.com

命名空间

变体

视图

操作