std:: strtoul, std:: strtoull
|
定义于头文件
<cstdlib>
|
||
|
unsigned
long
strtoul
(
const
char
*
str,
char
**
str_end,
int
base
)
;
|
(1) | |
|
unsigned
long
long
strtoull
(
const
char
*
str,
char
**
str_end,
int
base
)
;
|
(2) | (C++11 起) |
将 str 所指向的字节字符串中的无符号整数值进行解析。
丢弃所有空白字符(通过调用
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 locale 可能接受其他数字格式。
如果
base
的值为
0
,将自动检测数字进制:若前缀为
0
则为八进制,若前缀为
0x
或
0X
则为十六进制,否则为十进制。
如果减号是输入序列的一部分,则从数字序列计算得出的数值将被取反,如同在结果类型中通过 一元减号 运算符处理,该操作遵循无符号整数回绕规则。
该函数将 str_end 指向的指针设置为指向最后一个被解释字符之后的位置。如果 str_end 是空指针,则此操作将被忽略。
目录 |
参数
| str | - | 指向待解析的空终止字节字符串的指针 |
| str_end | - | 指向字符指针的指针,可被设置为最后一个已解析字符之后的位置 |
| base | - | 被解析整数值的 基数 |
返回值
成功时返回与
str
内容对应的整数值。若转换值超出对应返回类型的范围,则发生范围错误(
errno
被设为
ERANGE
)并返回
ULONG_MAX
或
ULLONG_MAX
。若无法执行任何转换,则返回
0
。
示例
#include <cstdlib> #include <errno.h> #include <iostream> #include <string> int main() { const char* p = "10 200000000000000000000000000000 30 -40 - 42"; char* end = nullptr; std::cout << "Parsing '" << p << "':\n"; for (unsigned long i = std::strtoul(p, &end, 10); p != end; i = std::strtoul(p, &end, 10)) { std::cout << "'" << std::string(p, end - p) << "' -> "; p = end; if (errno == ERANGE) { errno = 0; std::cout << "range error, got "; } std::cout << i << '\n'; } std::cout << "After the loop p points to '" << p << "'\n"; }
可能的输出:
Parsing '10 200000000000000000000000000000 30 -40 - 42': '10' -> 10 ' 200000000000000000000000000000' -> range error, got 18446744073709551615 ' 30' -> 30 ' -40' -> 18446744073709551576 After the loop p points to ' - 42'
参见
|
(C++11)
(C++11)
|
将字符串转换为无符号整数
(函数) |
|
(C++11)
|
将字节字符串转换为整数值
(函数) |
|
(C++11)
(C++11)
|
将字节字符串转换为
std::intmax_t
或
std::uintmax_t
(函数) |
|
将宽字符串转换为无符号整数值
(函数) |
|
|
将字节字符串转换为浮点值
(函数) |
|
|
(C++17)
|
将字符序列转换为整数或浮点值
(函数) |
|
(C++11)
|
将字节字符串转换为整数值
(函数) |
|
C 文档
用于
strtoul
,
strtoull
|
|