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

basic_string substr( size_type pos = 0, size_type count = npos ) const;		(C++20 前)
constexpr basic_string substr( size_type pos = 0, size_type count = npos ) const;		(C++20 起)

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

参数

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

返回值

含子串 [pos, pos+count) 或 [pos, size()) 的 string 。

异常

若 pos > size() 则为 std::out_of_range 。

复杂度

与 count 成线性。

注解

如同以 basic_string(data()+pos, count) 构造返回的 string ，这隐含将会默认构造返回的 string 的分配器——新分配器将不是 this->get_allocator() 的副本。

示例

运行此代码

#include <string>
#include <iostream>
 
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& e) {
        std::cout << "pos exceeds string size\n";
    }
}

输出：

abcdefghij
567
hij
pos exceeds string size

参阅

copy	复制字符 (公开成员函数)
sizelength	返回字符数 (公开成员函数)
find	于字符串中寻找字符 (公开成员函数)
npos [静态]	特殊值。准确含义依赖语境 (公开静态成员常量)

语言
标准库头文件
自立与有宿主实现
具名要求
语言支持库
概念库 (C++20)
诊断库
工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
原子操作库 (C++11)
线程支持库 (C++11)
技术规范

空终止字符串
字节字符串
多字节字符串
宽字符串
类
basic_string
basic_string_view (C++17)
char_traits

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

参数

返回值

异常

复杂度

注解

示例

参阅

导航