strtoul, _strtoul_l, wcstoul, _wcstoul_l

아티클
02/21/2013

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

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

매개 변수

nptr
변환 하려면 null로 끝나는 문자열입니다.
endptr
검색을 중지 하는 문자에 대 한 포인터입니다.
base
사용할 수 기준입니다.
locale
사용 하는 로캘.

반환 값

strtoul있는 경우 변환 된 값을 반환 하거나 ULONG_MAX 오버플로 합니다.strtoul변환할 수 있는 경우 0을 반환 합니다.wcstoulanalogously에 값을 반환 합니다 strtoul.두 함수에 대 한 errno 로 설정 된 ERANGE 오버플로 또는 언더플로가 발생 하는 경우.

참조 하십시오 _doserrno, errno, _sys_errlist, 및 _sys_nerr , 및 기타에 대 한 자세한 내용은 코드를 반환 합니다.

설명

이러한 각 함수는 입력된 문자열을 변환 nptr 에 있는 unsignedlong.

strtoul읽기를 중단 nptr 에서 숫자의 일부로 인식할 수 없는 첫 번째 문자입니다.종료 null 문자를 수 있습니다 또는 첫 번째 숫자 보다 크거나 수 있습니다 base.LC_NUMERIC 로케일의 범주 설정을 결정의 기 수 문자로 인식 nptr. 자세한 내용은 >setlocale.strtoul및 wcstoul ; 현재 로캘을 사용 하 여 _strtoul_l및 _wcstoul_l 는 대신 전달 된 로케일을 사용할 경우를 제외 하 고 동일 합니다.자세한 내용은 로캘를 참조하십시오.

경우 endptr 수 없습니다 NULL, 포인터가 가리키는 위치에 검사를 중지 하는 문자에 대 한 포인터 저장 됩니다 endptr.변환할 수 있는 경우 (없음 올바른 숫자를 찾을 수 없습니다 또는 잘못 된 자료는 지정 된) 값을 nptr 가 가리키는 위치에 저장 된 endptr.

wcstoul와이드 문자 버전입니다 strtoul. 해당 nptr 인수는 와이드 문자열입니다.그렇지 않으면 이러한 함수를 동일 하 게 동작합니다.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul예상 nptr 다음과 같은 형식의 문자열을 가리키도록 합니다.

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

A whitespace 는 무시 됩니다; 공백, 탭 문자 중 구성 될 수 있습니다 digits10 진수 숫자입니다.이 양식에 맞지 않는 첫 번째 문자 검색을 중지 합니다.경우 base 2 사이의 36, 수의 기준으로 사용 되 고 있습니다.경우 base 가 가리키는 문자열의 초기 문자 0 이며 nptr 기본 결정 하는 데 사용 됩니다.첫 번째 문자 0 이며 두 번째 문자가 'x' 나 '0x' 되 면 문자열 8 진수 정수로 해석 됩니다. 그렇지 않으면이 값은 10 진수로 해석 됩니다.첫 번째 문자 '0'이 고 두 번째 문자 경우 'x' 나 '0x' 문자열은 16 진수 정수로 해석 됩니다.' 1'부터 ' 9' 까지의 첫 번째 문자가 있으면 문자열을 10 진수로 해석 됩니다.문자 'a'부터 'z'를 'A'부터 'Z'까지 35-10 값 할당 됩니다. 문자 할당 된 값 보다 작은 base 사용할 수 있습니다.strtoul더하기 수 있습니다 (+) 또는 빼기 (-) (–) 기호 접두사입니다. 반환 값이 무효화 되어 선행 음수 기호를 나타냅니다.