wcstoul, wcstoull

str 이 가리키는 와이드 문자열에서 부호 없는 정수 값을 해석합니다.

(호출 iswspace 로 식별되는) 모든 공백 문자들을 버리고 첫 번째 비-공백 문자를 찾은 후, 유효한 base-n (여기서 n= base ) 부호 없는 정수 숫자 표현을 형성하기 위해 가능한 많은 문자들을 취하여 정수 값으로 변환합니다. 유효한 부호 없는 정수 값은 다음 부분들로 구성됩니다:

• (선택 사항) 양수 또는 음수 부호
• (선택 사항) 접두사 ( 0 ) - 8진법 기수 표시 (기수가 8 또는 ​ 0 ​ 인 경우에만 적용)
• (선택 사항) 접두사 ( 0x 또는 0X ) - 16진법 기수 표시 (기수가 16 또는 ​ 0 ​ 인 경우에만 적용)
• 숫자 시퀀스

유효한 base 값의 집합은 {0, 2, 3, ..., 36} 입니다. base- 2 정수에 대한 유효한 숫자 집합은 {0, 1} , base- 3 정수에 대한 유효한 숫자 집합은 {0, 1, 2} 입니다. 10 보다 큰 base의 경우, 유효한 숫자에는 알파벳 문자가 포함되며, base- 11 정수에 대한 Aa 부터 base- 36 정수에 대한 Zz 까지입니다. 문자 대소문자는 무시됩니다.

현재 설치된 C locale 에서는 추가 숫자 형식을 허용할 수 있습니다.

base 의 값이 ​ 0 ​ 인 경우, 숫자 진법은 자동으로 감지됩니다: 접두사가 0 이면 8진법, 접두사가 0x 또는 0X 이면 16진법, 그 외의 경우에는 10진법입니다.

마이너스 부호가 입력 시퀀스의 일부였다면, 숫자 시퀀스로 계산된 숫자 값은 결과 타입에서 단항 마이너스 연산자에 의해 부호가 반전되며, 이는 부호 없는 정수 래핑 규칙을 적용합니다.

이 함수는 str_end 가 가리키는 포인터를 해석된 마지막 문자 다음의 와이드 문자를 가리키도록 설정합니다. str_end 가 널 포인터인 경우, 이는 무시됩니다.

매개변수

반환값

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

참조문헌