strtoul, _strtoul_l, wcstoul, _wcstoul_l

문자열을 부호 없는 long 정수값으로 변환합니다.

구문

unsigned long strtoul(
   const char *strSource,
   char **endptr,
   int base
);
unsigned long _strtoul_l(
   const char *strSource,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base
);
unsigned long _wcstoul_l(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

매개 변수

strSource
변환할 Null 종료 문자열입니다.

endptr
검색을 중지하는 문자에 대한 포인터입니다.

base
사용할 기수입니다.

locale
사용할 로캘입니다.

반환 값

strtoul은 변환된 값(있는 경우)을 반환하거나 오버플로 시에는 ULONG_MAX를 반환합니다. 변환을 수행할 수 없으면 strtoul은 0을 반환합니다. wcstoul는 strtoul와 동일한 값을 반환합니다. 두 함수에서 모두 오버플로 또는 언더플로가 발생하면 errno는 ERANGE로 설정됩니다.

반환 코드에 대한 자세한 내용은 , , 및 를 참조하세요errno._sys_nerr_sys_errlist_doserrno

설명

이러한 각 함수는 입력 문자열 strSource을 unsigned long으로 변환합니다.

strtoul 는 숫자의 일부로 인식할 수 없는 첫 번째 문자에서 문자열 strSource 을 읽는 것을 중지합니다. 이 문자는 종결 NULL문자이거나 첫 번째 숫자 문자가 1보다 크거나 같을 base수 있습니다. 로캘의 범주 설정에 LC_NUMERIC 따라 radix 문자 strSource의 인식이 결정됩니다. 자세한 내용은 다음을 참조하세요 setlocale. strtoul 및 wcstoul은 현재 로캘을 사용합니다. _strtoul_l 및 _wcstoul_l은 전달된 로캘을 대신 사용한다는 점을 제외하면 동일합니다. 자세한 내용은 Locale을 참조하세요.

그렇지 않은 NULL경우 endptr 검색을 중지한 문자에 대한 포인터가 가리키는 위치에 endptr저장됩니다. 올바른 숫자를 찾을 수 없거나 잘못된 밑을 지정하여 변환을 수행할 수 없는 경우에는 strSource의 값이 endptr에서 가리키는 위치에 저장됩니다.

wcstoul은 strtoul의 와이드 문자 버전입니다. 이 함수의 strSource 인수는 와이드 문자열입니다. 그 외의 경우에는 이들 함수가 동일하게 동작합니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul에서는 strSource이 다음 형식의 문자열을 가리켜야 합니다.

[whitespace] [{+ | -}] [0 [{ x | X }]] [digits | letters]

A는 whitespace 무시되는 공백 및 탭 문자로 구성될 수 있습니다. digits 은 하나 이상의 소수 자릿수입니다. letters 는 하나 이상의 문자를 a 통해 z (또는 A 통과 Z)입니다. 이 양식에 맞지 않는 첫 번째 문자는 검사를 중지합니다. 2에서 36 사이이면 base 숫자의 기준으로 사용됩니다. base가 0인 경우에는 strSource에서 가리키는 문자열의 초기 문자를 사용하여 밑을 결정합니다. 첫 번째 문자가 0이고 두 번째 문자가 아닌 xX경우 문자열은 8진수 정수로 해석됩니다. 첫 번째 문자가 '0'이고 두 번째 문자가 x 또는 X문자열이 16진수 정수로 해석됩니다. 첫 번째 문자가 '1'~'9' 이면 문자열은 10진수 정수로 해석됩니다. 문자 a 통과 z (또는 A 통과 Z)에는 10에서 35까지의 값이 할당되며, 할당된 값이 허용되는 것보다 base 작은 문자만 할당됩니다. 밑의 범위를 벗어난 첫 번째 문자가 발견되면 검색이 중지됩니다. 예를 들어 base가 0인데 처음 검색된 문자가 '0'이면 문자열은 8진수 정수로 간주되며 '8' 또는 '9' 문자가 발견되면 검색은 중지됩니다. strtoul에서는 더하기 기호(+) 또는 빼기 기호(-) 접두사를 사용할 수 있습니다. 선행 빼기 기호는 반환 값이 부정됨을 나타냅니다.

요구 사항

루틴에서 반환된 값	필수 헤더
strtoul	<stdlib.h>
wcstoul	<stdlib.h> 또는 <wchar.h>
_strtoul_l	<stdlib.h>
_wcstoul_l	<stdlib.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

에 대한 예제를 strtod참조하세요.

참고 항목

데이터 변환
Locale
localeconv
setlocale, _wsetlocale
문자열에서 숫자 값 함수로
strtod, _strtod_l, wcstod, _wcstod_l
strtol, wcstol, _strtol_l, _wcstol_l
atof, _atof_l, _wtof, _wtof_l