wcstoul

解释由指向的宽字符串中的无符号整数值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接受locale。

如果基数的值是​0​，数字基地是自动检测：如果前缀是0，基地是八进制的，如果前缀是0x或0X，基地是十六进制，否则基数是十进制。

如果减号是输入序列的一部分，则根据数字序列计算的数值将被否定，如同使用无符号整数环绕规则的结果类型中的一元减号一样。

这些函数将指向的指针设置为指向str_end最后解释的字符后面的宽字符。如果str_end是NULL，它被忽略。

参数

返回值

整数值对应str于成功的内容。如果转换后的值超出了相应返回类型的范围，则会发生范围错误并返回ULONG_MAX或ULLONG_MAX。如果不能执行转换，​则返回0​。

示例

​

#include <stdio.h>
#include <errno.h>
#include <wchar.h>
 
int main(void)
{
    const wchar_t *p = L"10 200000000000000000000000000000 30 40";
    printf("Parsing L'%ls':\n", p);
    wchar_t *end;
    for (unsigned long i = wcstoul(p, &end, 10);
         p != end;
         i = wcstoul(p, &end, 10))
    {
        printf("'%.*ls' -> ", (int)(end-p), p);
        p = end;
        if (errno == ERANGE){
            printf("range error, got ");
            errno = 0;
        }
        printf("%lu\n", i);
    }
}

​

输出：

​

Parsing '10 200000000000000000000000000000 30 40':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' 40' -> 40

​

参考

• C11标准（ISO/IEC 9899:2011）：
  • 7.29.4.1.2 wcstol，wcstoll，wcstoul和wcstoull函数（p: 429-430）
• C99标准（ISO/IEC 9899:1999）：
  • 7.24.4.1.2 wcstol，wcstoll，wcstoul和wcstoull函数（p: 375-376）

另请参阅

| wcstoul，wcstoull |的C ++文档