strtol函数、strtoul函数

strtol函数：将字符串转换成long(长整型数)

描述

C 库函数 long int strtol(const char *str, char **endptr, int base) 把参数 str 所指向的字符串根据给定的 base 转换为一个长整数（类型为 long int 型），base 必须介于 2 和 36（包含）之间，或者是特殊值 0。

声明

下面是 strtol() 函数的声明。

long int strtol(const char *str, char **endptr, int base);

strtol() 会扫描参数 str 字符串，跳过前面的空白字符（例如空格，tab缩进等，可以通过 isspace() 函数来检测），直到遇上数字或正负符号才开始做转换，再遇到非数字或字符串结束时(’\0’)结束转换，并将结果返回。

参数

str 要转换为长整数的字符串。
endptr 对类型为 char* 的对象的引用，其值由函数设置为 str 中数值后的下一个字符。
base 基数（为字符串 str 所采用的进制），必须介于 2 和 36（包含）之间，或者是特殊值 0。

注意：

• 当 base 的值为 0 时，默认采用 10 进制转换，但如果遇到 ‘0x’ / ‘0X’ 前置字符则会使用 16 进制转换，遇到 ‘0’ 前置字符则会使用 8 进制转换。
• 若endptr 不为NULL，则会将遇到的不符合条件而终止的字符指针由 endptr 传回；若 endptr 为 NULL，则表示该参数无效，或不使用该参数。

返回值

返回转换后的长整型数；
如果不能转换或者 str 为空字符串，那么返回 0(0L)；
如果转换得到的值超出 long int 所能表示的范围，函数将返回 LONG_MAX 或 LONG_MIN（在 limits.h 头文件中定义），并将 errno 的值设置为 ERANGE。

实例

下面的实例演示了 strtol() 函数的用法。

#include <stdio.h>
#include <stdlib.h>

int main()
{
   char str[30] = "60c0c0 This is test";
   char *ptr;
   long ret;

   ret = strtol(str, &ptr, 16);
   printf("数字（无符号长整数）是 %ld\n", ret);
   printf("字符串部分是 |%s|", ptr);

   return(0);
}

结果：

数字（无符号长整数）是 6340800
字符串部分是 | This is test|

strtoul函数：将字符串转换成unsigned long(无符号长整型数)

描述

C 库函数 unsigned long int strtoul(const char *str, char **endptr, int base) 把参数 str 所指向的字符串根据给定的 base 转换为一个无符号长整数（类型为 unsigned long int 型），base 必须介于 2 和 36（包含）之间，或者是特殊值 0。

声明

下面是 strtoul() 函数的声明。

unsigned long int strtoul(const char *str, char **endptr, int base);

参数

str 要转换为无符号长整数的字符串。
endptr 对类型为 char* 的对象的引用，其值由函数设置为 str 中数值后的下一个字符。
base 基数（为字符串 str 所采用的进制），必须介于 2 和 36（包含）之间，或者是特殊值 0。

注意：

• 当 base 的值为 0 时，默认采用 10 进制转换，但如果遇到 ‘0x’ / ‘0X’ 前置字符则会使用 16 进制转换，遇到 ‘0’ 前置字符则会使用 8 进制转换。
• 若 endptr 不为NULL，则会将遇到的不符合条件而终止的字符指针由 endptr 传回；若 endptr 为 NULL，则表示该参数无效，或不使用该参数。本文最后的范例没有展示 endptr 参数的使用，你可以参考 strtol() 函数的范例来更加直观地了解 endptr 参数。

返回值

返回转换后的无符号长整型数；
如果不能转换或者 str 为空字符串，那么返回 0；
如果转换得到的值超出unsigned long int 所能表示的范围，函数将返回 ULONG_MAX（在 limits.h 头文件中定义），并将 errno 的值设置为 ERANGE。

实例

下面的实例演示了 strtoul() 函数的用法。

#include <stdio.h>
#include <stdlib.h>

int main()
{
   char str[30] = "2020108 This is test";
   char *ptr;
   long ret;

   ret = strtoul(str, &ptr, 10);
   printf("数字（无符号长整数）是 %lu\n", ret);
   printf("字符串部分是 |%s|", ptr);

   return(0);
}

结果：

数字（无符号长整数）是 2020108
字符串部分是 | This is test|