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

在标头 `<string>` 定义
int stoi ( const std::string& str, std::size_t* pos = nullptr, int base = 10 );	(1)	(C++11 起)
int stoi ( const std::wstring& str, std::size_t* pos = nullptr, int base = 10 );	(2)	(C++11 起)
long stol ( const std::string& str, std::size_t* pos = nullptr, int base = 10 );	(3)	(C++11 起)
long stol ( const std::wstring& str, std::size_t* pos = nullptr, int base = 10 );	(4)	(C++11 起)
long long stoll( const std::string& str, std::size_t* pos = nullptr, int base = 10 );	(5)	(C++11 起)
long long stoll( const std::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)。

舍弃所有空白符（以调用 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()
{
    const auto data =
    {
        "45",
        "+45",
        " -45",
        "3.14159",
        "31337 with words",
        "words and 2",
        "12345678901",
    };
 
    for (const std::string s : data)
    {
        std::size_t pos{};
        try
        {
            std::cout << "std::stoi(" << std::quoted(s) << ")：";
            const int i{std::stoi(s, &pos)};
            std::cout << i << "；pos：" << pos << '\n';
        }
        catch (std::invalid_argument const& ex)
        {
            std::cout << "std::invalid_argument::what()：" << ex.what() << '\n';
        }
        catch (std::out_of_range const& ex)
        {
            std::cout << "std::out_of_range::what()：" << ex.what() << '\n';
            const long long ll{std::stoll(s, &pos)};
            std::cout << "std::stoll(" << std::quoted(s) << ")：" << ll
                      << "；pos：" << pos << '\n';
        }
    }
 
    std::cout << "\n以不同的底进行调用：\n";
    for (const auto& [s, base] : {std::pair<const char*, int>
        {"11",  2}, {"22",  3}, {"33",  4}, {"77",  8},
        {"99", 10}, {"FF", 16}, {"jJ", 20}, {"Zz", 36}})
    {
        const int 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` (函数)

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

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

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

参数

返回值

异常

示例

缺陷报告

参阅

导航