strtol
在头文件<stdlib.h>中定义 | | |
|---|---|---|
long strtol（const char * str，char ** str_end，int base）; | | （直到C99） |
long strtol（const char * restrict str，char ** restrict str_end，int base）; | | （自C99以来） |
long long strtoll（const char * restrict str，char ** restrict str_end，int base）; | | （自C99以来） |
解释str指向的字节字符串中的整数值。
放弃任何空格字符（通过调用标识isspace()），直到找到第一个非空白字符，然后接收尽可能多的字符以形成有效的base-n（其中n = base）整数表示并将它们转换为整数值。有效的整数值由以下部分组成：
- （可选）加号或减号
- （可选）prefix（
0）指示八进制基数（只适用于基数为8或0） - （可选）前缀（
0x或0X）表示十六进制基数（仅适用于基数为16或0） - 数字序列
base的有效值集合是{0,2,3，...，36}。base-2整数的有效数字集合是{0,1}，对于base-3整数是{0,1,2}，依此类推。对于大于等于的基数10，有效数字包含字母字符，从Aa基数为11的整数开始，到Zz基数为36的整数。字符的情况被忽略。
其他数字格式可以被当前安装的C语言环境接受。
如果基数的值是0，数字基地是自动检测：如果前缀是0，基地是八进制的，如果前缀是0x或0X，基地是十六进制，否则基数是十进制。
如果减号是输入序列的一部分，则根据数字序列计算的数值将被否定，如同在结果类型中使用一元减号一样。
这些函数将str_end指向的指针设置为指向经过最后解释的字符的字符。 如果str_end是NULL，它将被忽略。
如果str为空或者没有预期的形式，则不执行转换，并且（如果str_end不是NULL），则str的值将存储在str_end指向的对象中。
参数
str | - | 指向要解释的以空字符结尾的字节字符串 |
|---|---|---|
str_end | - | 指向字符的指针。 |
base | - | 解释的整数值的基数 |
返回值
- 如果成功，
str则返回与内容相对应的整数值。 - 如果转换后的值脱离的相应返回类型的范围时，发生错误的范围（设定
errno到ERANGE）和LONG_MAX，LONG_MIN，LLONG_MAX或LLONG_MIN返回。 - 如果不能执行转换，
0则被返回。
例
#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
int main(void)
{
// parsing with error handling
const char *p = "10 200000000000000000000000000000 30 -40 junk";
printf("Parsing '%s':\n", p);
char *end;
for (long i = strtol(p, &end, 10);
p != end;
i = strtol(p, &end, 10))
{
printf("'%.*s' -> ", (int)(end-p), p);
p = end;
if (errno == ERANGE){
printf("range error, got ");
errno = 0;
}
printf("%ld\n", i);
}
// parsing without error handling
printf("\"1010\" in binary --> %ld\n", strtol("1010",NULL,2));
printf("\"12\" in octal --> %ld\n", strtol("12",NULL,8));
printf("\"A\" in hex --> %ld\n", strtol("A",NULL,16));
printf("\"junk\" in base-36 --> %ld\n", strtol("junk",NULL,36));
printf("\"012\" in auto-detected base --> %ld\n", strtol("012",NULL,0));
printf("\"0xA\" in auto-detected base --> %ld\n", strtol("0xA",NULL,0));
printf("\"junk\" in auto-detected base --> %ld\n", strtol("junk",NULL,0));
}输出：
Parsing '10 200000000000000000000000000000 30 -40 junk':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 9223372036854775807
' 30' -> 30
' -40' -> -40
"1010" in binary --> 10
"12" in octal --> 10
"A" in hex --> 10
"junk" in base-36 --> 926192
"012" in auto-detected base --> 10
"0xA" in auto-detected base --> 10
"junk" in auto-detected base --> 0参考
- C11标准（ISO / IEC 9899：2011）：
- 7.22.1.4阶段，阶段，阶段和阶段功能（p：344-345）
- C99标准（ISO / IEC 9899：1999）：
- 7.20.1.4阶段，阶段，阶段和阶段功能（P：310-311）
- C89 / C90标准（ISO / IEC 9899：1990）：
- 4.10.1.5 strtol函数
扩展内容
atoiatolatoll（C99） | 将字节字符串转换为整数值（函数） |
|---|---|
strtoul strtoull（C99） | 将字节字符串转换为无符号整数值（函数） |
wcstolwcstoll（C95）（C99） | 将宽字符串转换为整数值（函数） |
wcstoulwcstoull（C95）（C99） | 将宽字符串转换为无符号整数值（函数） |
| strtol，strtoll的C ++文档 |
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
