Linux程序员手册 第3部分
更新日期： 2020-06-09

名称

strtoul，strtoull，strtouq-将字符串转换为无符号长整数

语法

#include <stdlib.h>

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

unsigned long long int strtoull(const char *nptr, char **endptr,
                                int base);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

strtoull()：

_ISOC99_SOURCE || || / * Glibc版本

说明

strtoul()函数根据给定的基数将nptr中字符串的初始部分转换为无符号的long int值，该值必须介于2到36之间(包括2和36)，或者是特殊值0。

该字符串可以以任意数量的空格(由isspace(3)确定)开头，后跟一个可选的aq + aq或aq-aq符号。如果base为零或16，则字符串可以包含一个" 0x"前缀，并且该数字将以16为基数；否则，该字符串将以16为基数。否则，除非下一个字符是aq0aq，否则零基将被视为10(十进制)，在这种情况下，它将被视为8(八进制)。

字符串的其余部分以明显的方式转换为无符号long int值，停在给定基数中不是有效数字的第一个字符处。 (在大于10的基数中，大写或小写字母aqAaq代表10，aqBaq代表11，依此类推，aqZaq代表35。)

如果endptr不为NULL，则strtoul()将第一个无效字符的地址存储在* endptr中。如果根本没有数字，则strtoul()将nptr的原始值存储在* endptr中(并返回0)。特别是，如果返回时* nptr不是aq \ 0aq，而** endptr是aq \ 0aq，则整个字符串都是有效的。

strtoull()函数的工作原理与strtoul()函数相同，但返回的是无符号long long int值。

返回值

strtoul()函数返回转换结果，或者如果存在前导减号，则返回转换结果的取反，表示为无符号值，除非原始(取整)值溢出。在后一种情况下，strtoul()返回ULONG_MAX并将errno设置为ERANGE。对于strtoull()完全相同(用ULLONG_MAX代替ULONG_MAX)。

错误说明

EINVAL

(不适用于C99)给定的基数包含不受支持的值。

ERANGE

所得值超出范围。

如果未执行转换(未看到数字，则返回0)，该实现还可以将errno设置为EINVAL。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

strtoul()：POSIX.1-2001，POSIX.1-2008，C89，C99 SVr4。

strtoull()：POSIX.1-2001，POSIX.1-2008，C99。

备注

由于strtoul()在成功和失败时都可以合法地返回0或ULONG_MAX(对于strtoull()为ULLONG_MAX)，因此调用程序应在调用之前将errno设置为0，然后通过检查errno是否为非零值来确定是否发生了错误。通话后。

在" C"语言环境以外的语言环境中，可以接受其他字符串。 (例如，可能支持当前语言环境的千位分隔符。)

BSD也有

u_quad_t strtouq(const char *nptr, char **endptr, int base);

具有完全相似的定义。根据当前体系结构的大小，这可能等效于strtoull()或strtoul()。

负值被认为是有效输入，并且将被静默转换为等效的无符号long int值。

示例

请参见strtol(3)手册页上的示例；本手册页中描述的功能的用法类似。

另外参见

a64l(3)，atof(3)，atoi(3)，atol(3)，strtod(3)，strtol(3)，strtoumax(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。