std::wcstoul, std::wcstoull

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库(C++11)

格式化库(C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

初等数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码识别

text_encoding (C++26)

 

空终止宽字符串

函数
字符分类
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
字符操作
towlower towupper	towctrans wctrans
转换到数值格式
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
字符串检验
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
数组操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
类型 wctrans_t wctype_t wint_t	宏 WCHAR_MIN WCHAR_MAX WEOF

 

在标头 <cwchar> 定义
unsignedlong      wcstoul (constwchar_t* str, wchar_t** str_end, int base );
unsignedlonglong wcstoull(constwchar_t* str, wchar_t** str_end, int base );		(C++11 起)

转译 str 所指向的宽字符串中的无符号整数值。

舍弃所有空白符（以调用 std::iswspace 鉴别），直到找到首个非空白符，然后取尽可能多的字符组成合法的底 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 内容的整数值。若转换后的值落在对应返回类型的范围外，则出现值域错误并返回 ULONG_MAX 和 ULLONG_MAX。若不能进行转换，则返回 ​0​。

示例

运行此代码

#include <cwchar>#include <errno.h>#include <iostream>#include <string>   int main(){constwchar_t* p = L"10 200000000000000000000000000000 30 40";wchar_t* end;std::wcout<<"解析 L'"<< p <<"':\n";for(unsignedlong i = std::wcstoul(p, &end, 10); p != end; i = std::wcstoul(p, &end, 10)){std::wcout<<'\''<<std::wstring(p, end - p)<<"' -> "; p = end;if(errno==ERANGE){std::wcout<<"值域错误, 得到 ";errno=0;}std::wcout<< i <<'\n';}}

可能的输出：

解析 L'10 200000000000000000000000000000 30 40': '10' -> 10 ' 200000000000000000000000000000' -> 值域错误, 得到 18446744073709551615 ' 30' -> 30 ' 40' -> 40

参阅

strtoulstrtoull (C++11)	转换字节字符串为无符号整数值 (函数)
wcstolwcstoll	转换宽字符串为整数值 (函数)
wcstoul, wcstoull 的 C 文档