strtoul, strtoull

 

C

编译器支持

语言

头文件

类型支持

程序工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持(C11)

技术规范

符号索引

 

字符串库

空终止字节字符串

空终止多字节字符串

空终止宽字符串

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换成数值格式
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfromld (C23)(C23)(C23)
字符串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字符串检验
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
杂项
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

在标头 <stdlib.h> 定义
unsignedlong      strtoul(constchar*          str, char**          str_end,                             int base );		(C99 前)
unsignedlong      strtoul(constchar*restrict str, char**restrict str_end,                             int base );		(C99 起)
unsignedlonglong strtoull(constchar*restrict str, char**restrict str_end,                              int base );		(C99 起)

转换 str 所指的字符串中的无符号整数。

舍弃所有空白符（以调用 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，那么底是十六进制，否则底是十进制。

如果符号是输入序列的一部分，那么对从数字序列计算得来的数字值取反，如同用结果类型的一元减，它对无符号整数应用回绕规则。

函数设置 str_end 所指向的指针指向最后一个被转换字符的后一字符。若 str_end 为空指针，则忽略它。

参数

str	-	指向要被转换的空终止字符串的指针
str_end	-	指向指向字符的指针的指针
base	-	被转换整数的底

返回值

成功时为对应 str 内容的整数。若被转换值落在对应返回类型的范围外，则发生值域错误（errno 被设为 ERANGE）并返回 ULONG_MAX 或 ULLONG_MAX。若无转换可进行，则返回 ​0​。

示例

运行此代码

#include <errno.h>#include <stdio.h>#include <stdlib.h>   int main(void){constchar* p ="10 200000000000000000000000000000 30 -40 - 42";printf("解析 '%s':\n", p);char* end =NULL;for(unsignedlong i = strtoul(p, &end, 10); p != end; i = strtoul(p, &end, 10)){printf("'%.*s' -> ", (int)(end - p), p); p = end;if(errno==ERANGE){errno=0;printf("值域错误，得到 ");}printf("%lu\n", i);}printf("循环后 p 指向 '%s'\n", p);}

输出：

解析 '10 200000000000000000000000000000 30 -40 - 42': '10' -> 10 ' 200000000000000000000000000000' -> 值域错误，得到 18446744073709551615 ' 30' -> 30 ' -40' -> 18446744073709551576 循环后 p 指向 ' - 42'

引用

• C23 标准（ISO/IEC 9899:2024）：

• 7.24.1.7 The strtol, strtoll, strtoul, and strtoull functions （第 TBD 页）

• C17 标准（ISO/IEC 9899:2018）：

• 7.22.1.4 The strtol, strtoll, strtoul, and strtoull functions （第 251-252 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.22.1.4 The strtol, strtoll, strtoul, and strtoull functions （第 344-345 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.20.1.4 The strtol, strtoll, strtoul, and strtoull functions （第 310-311 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.10.1.6 The strtoul function

参阅

wcstoulwcstoull (C95)(C99)	转换宽字符串为无符号整数 (函数)
atoiatolatoll (C99)	将字节字符串转换成整数 (函数)
strtolstrtoll (C99)	将字节字符串转换成整数 (函数)
strtoul 的 C++ 文档