std::stoi, std::stol, std::stoll
来自cppreference.com
< cpp | string | basic string
定义于头文件 <string>
|
||
int stoi( const std::string& str, std::size_t* pos = 0, int base = 10 ); int stoi( const std::wstring& str, std::size_t* pos = 0, int base = 10 ); |
(1) | (C++11 起) |
long stol( const std::string& str, std::size_t* pos = 0, int base = 10 ); long stol( const std::wstring& str, std::size_t* pos = 0, int base = 10 ); |
(2) | (C++11 起) |
long long stoll( const std::string& str, std::size_t* pos = 0, int base = 10 ); long long stoll( const std::wstring& str, std::size_t* pos = 0, int base = 10 ); |
(3) | (C++11 起) |
转译字符串 str
中的有符号整数值。
舍弃所有空白符(以调用 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 <iostream> #include <string> int main() { std::string str1 = "45"; std::string str2 = "3.14159"; std::string str3 = "31337 with words"; std::string str4 = "words and 2"; int myint1 = std::stoi(str1); int myint2 = std::stoi(str2); int myint3 = std::stoi(str3); // 错误: 'std::invalid_argument' // int myint4 = std::stoi(str4); std::cout << "std::stoi(\"" << str1 << "\") is " << myint1 << '\n'; std::cout << "std::stoi(\"" << str2 << "\") is " << myint2 << '\n'; std::cout << "std::stoi(\"" << str3 << "\") is " << myint3 << '\n'; //std::cout << "std::stoi(\"" << str4 << "\") is " << myint4 << '\n'; }
输出:
std::stoi("45") is 45 std::stoi("3.14159") is 3 std::stoi("31337 with words") is 31337
参阅
(C++11)(C++11) |
转换字符串为无符号整数 (函数) |
(C++11)(C++11)(C++11) |
转换字符串为浮点值 (函数) |
(C++11) |
转换字节字符串为整数值 (函数) |
(C++11) |
转换字节字符串为无符号整数值 (函数) |
(C++11)(C++11) |
转换字节字符串为 std::intmax_t 或 std::uintmax_t (函数) |
(C++17) |
转换字符序列到整数或浮点值 (函数) |
(C++11) |
转换字节字符串为整数值 (函数) |
(C++11) |
转换整数或浮点值为 string (函数) |
(C++11) |
转换整数或浮点值为 wstring (函数) |