std::stoul, std::stoull
来自cppreference.com
< cpp | string | basic string
在标头 <string> 定义
|
||
unsigned long stoul ( const std::string& str, std::size_t* pos = nullptr, int base = 10 ); |
(1) | (C++11 起) |
unsigned long stoul ( const std::wstring& str, std::size_t* pos = nullptr, int base = 10 ); |
(2) | (C++11 起) |
unsigned long long stoull( const std::string& str, std::size_t* pos = nullptr, int base = 10 ); |
(3) | (C++11 起) |
unsigned long long stoull( const std::wstring& str, std::size_t* pos = nullptr, int base = 10 ); |
(4) | (C++11 起) |
转译字符串 str 中的无符号整数值。
给定 ptr 为一个(提供给转换函数的)类型是 char* (1,3) 或 wchar_t* (2,4) 的内部指针:
1) 调用 std::strtoul(str.c_str(), &ptr, base)。
2) 调用 std::wcstoul(str.c_str(), &ptr, base)。
3) 调用 std::strtoull(str.c_str(), &ptr, base)。
4) 调用 std::wcstoull(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 | - | 数字基底 |
返回值
转换到指定无符号整数类型的字符串。
异常
- 无法进行转换时会抛出 std::invalid_argument。
- 转换值会落在结果类型的范围外,或底层函数(std::strtoul 或 std::strtoull)将 errno 设置为 ERANGE 时会抛出 std::out_of_range。
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
LWG 2009 | C++11 | 在 std::strtoul 或 std::strtoull 将 errno 设置为 ERANGE 时不会抛出 std::out_of_range | 会抛出 |
参阅
(C++11)(C++11)(C++11) |
转换字符串为有符号整数 (函数) |
(C++11)(C++11)(C++11) |
转换字符串为浮点值 (函数) |