std::stoi, std::stol, std::stoll

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

字符串库

类

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

成员函数 basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator 元素访问 basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) 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::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::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) 操作 basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

常量 basic_string::npos 非成员函数 operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline 比较 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20) 数值转换 stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) 字面量 operator""s (C++14) 辅助类 hash<std::basic_string> (C++11) 推导指引(C++17)

 

在标头 <string> 定义
int       stoi (conststd::string& str,                  std::size_t* pos = nullptr, int base =10);	(1)	(C++11 起)
int       stoi (conststd::wstring& str,                  std::size_t* pos = nullptr, int base =10);	(2)	(C++11 起)
long      stol (conststd::string& str,                  std::size_t* pos = nullptr, int base =10);	(3)	(C++11 起)
long      stol (conststd::wstring& str,                  std::size_t* pos = nullptr, int base =10);	(4)	(C++11 起)
longlong stoll(conststd::string& str,                  std::size_t* pos = nullptr, int base =10);	(5)	(C++11 起)
longlong stoll(conststd::wstring& str,                  std::size_t* pos = nullptr, int base =10);	(6)	(C++11 起)

转译字符串 str 中的有符号整数值。

令 ptr 为（提供给转换函数的）一个类型是 char*(1,3,5) 或 wchar_t*(2,4,6) 的内部指针：

1) 调用 std::strtol(str.c_str(), &ptr, base)。

2) 调用 std::wcstol(str.c_str(), &ptr, base)。

3) 调用 std::strtol(str.c_str(), &ptr, base)。

4) 调用 std::wcstol(str.c_str(), &ptr, base)。

5) 调用 std::strtoll(str.c_str(), &ptr, base)。

6) 调用 std::wcstoll(str.c_str(), &ptr, base)。

舍弃所有空白符（以调用 std::isspace 鉴别），直到找到首个非空白符，然后取尽可能多的字符组成合法的底 n （其中 n=base）的整数表示，并将它们转换成一个整数。合法的整数由下列部分组成：

• (可选)正或负号
• (可选)指示八进制底的前缀（0）（仅当底为 8 或 ​0​ 时应用）
• (可选)指示十六进制底的前缀（0x 或 0X）（仅当底为 16 或 ​0​ 时应用）
• 数字序列

底的合法集是 {0, 2, 3, ..., 36}。合法数字集对于底 2 整数是 {0, 1}，对于底 3 整数是 {0, 1, 2}，以此类推。对于大于 10 的底，合法数字包含字母字符，从对于底 11 整数的 Aa 到对于底 36 整数的 Zz。忽略字符大小写。

当前安装的 C 本地环境可能接受另外的数字格式。

如果 base 是 ​0​，那么自动检测数值进制：如果前缀是 0，那么底是八进制，如果前缀是 0x 或 0X，那么底是十六进制，否则底是十进制。

如果符号是输入序列的一部分，那么对从数字序列计算得来的数字值取反，如同用结果类型的一元减。

如果 pos 不是空指针，那么指针 ptr 会接收 str.c_str() 中首个未转换字符的地址，将计算该字符的下标将它存储到 *pos，该对象会给出转换所处理的字符数。

参数

str	-	要转换的字符串
pos	-	存储已处理字符数的整数的地址
base	-	数的底

返回值

对应 str 内容的整数值。

异常

• 无法进行转换时会抛出 std::invalid_argument。
• 转换值会落在结果类型的范围外，或底层函数（即 std::strtol 或 std::strtoll）将 errno 设置为 ERANGE 时会抛出 std::out_of_range。

示例

运行此代码

#include <iomanip>#include <iostream>#include <stdexcept>#include <string>#include <utility>   int main(){constauto data ={"45", "+45", " -45", "3.14159", "31337 with words", "words and 2", "12345678901", };   for(conststd::string s : data){std::size_t pos{};try{std::cout<<"std::stoi("<<std::quoted(s)<<")：";constint i{std::stoi(s, &pos)};std::cout<< i <<"；pos："<< pos <<'\n';}catch(std::invalid_argumentconst& ex){std::cout<<"std::invalid_argument::what()："<< ex.what()<<'\n';}catch(std::out_of_rangeconst& ex){std::cout<<"std::out_of_range::what()："<< ex.what()<<'\n';constlonglong ll{std::stoll(s, &pos)};std::cout<<"std::stoll("<<std::quoted(s)<<")："<< ll <<"；pos："<< pos <<'\n';}}   std::cout<<"\n以不同的底进行调用：\n";for(constauto&[s, base]:{std::pair<constchar*, int>{"11", 2}, {"22", 3}, {"33", 4}, {"77", 8}, {"99", 10}, {"FF", 16}, {"jJ", 20}, {"Zz", 36}}){constint i{std::stoi(s, nullptr, base)};std::cout<<"std::stoi("<<std::quoted(s)<<", nullptr, "<< base <<")："<< i <<'\n';}}

可能的输出：

std::stoi("45")：45；pos：2 std::stoi("+45")：45；pos：3 std::stoi(" -45")：-45；pos：4 std::stoi("3.14159")：3；pos：1 std::stoi("31337 with words")：31337；pos：5 std::stoi("words and 2")：std::invalid_argument::what()：stoi std::stoi("12345678901")：std::out_of_range::what()：stoi std::stoll("12345678901")：12345678901；pos：11   以不同的底进行调用： std::stoi("11", nullptr, 2)：3 std::stoi("22", nullptr, 3)：8 std::stoi("33", nullptr, 4)：15 std::stoi("77", nullptr, 8)：63 std::stoi("99", nullptr, 10)：99 std::stoi("FF", nullptr, 16)：255 std::stoi("jJ", nullptr, 20)：399 std::stoi("Zz", nullptr, 36)：1295

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 2009	C++11	在 std::strtol 或 std::strtoll 将 errno 设置为 ERANGE 时不会抛出 std::out_of_range	会抛出

参阅

stoulstoull (C++11)(C++11)	转换字符串为无符号整数 (函数)
stofstodstold (C++11)(C++11)(C++11)	转换字符串为浮点数 (函数)
strtolstrtoll (C++11)	转换字节字符串为整数值 (函数)
strtoulstrtoull (C++11)	转换字节字符串为无符号整数值 (函数)
strtoimaxstrtoumax (C++11)(C++11)	转换字节字符串为 std::intmax_t 或 std::uintmax_t (函数)
from_chars (C++17)	转换字符序列到整数或浮点数 (函数)
atoiatolatoll (C++11)	转换字节字符串为整数值 (函数)
to_string (C++11)	转换整数或浮点数为 string (函数)
to_wstring (C++11)	转换整数或浮点数为 wstring (函数)