strtol, wcstol, _strtol_l, _wcstol_l

아티클
02/21/2013

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

long strtol(
   const char *nptr,
   char **endptr,
   int base 
);
long wcstol(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
long _strtol_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
long _wcstol_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

매개 변수

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

반환 값

strtol문자열에 표시 되는 값을 반환 합니다. nptr표현에서 오버플로가 발생 합니다 경우에 반환 경우 제외 하 고, LONG_MAX 또는 LONG_MIN.strtol변환할 수 있는 경우 0을 반환 합니다.wcstolanalogously에 값을 반환 합니다 strtol.두 함수에 대 한 errno 로 설정 된 ERANGE 오버플로 또는 언더플로가 발생 하는 경우.

참조 하십시오 _doserrno, errno, _sys_errlist, 및 _sys_nerr 이 고 다른 반환 코드에 대 한 자세한 내용은.

설명

The strtol function converts nptr to a long.strtol읽기를 중단 nptr 에서 숫자의 일부로 인식할 수 없는 첫 번째 문자입니다.종료 null 문자를 수 있습니다 또는 첫 번째 숫자 보다 크거나 수 있습니다 base.

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

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_tcstol	strtol	strtol	wcstol
_tcstol_l	_strtol_l	_strtol_l	_wcstol_l

현재 로케일의 LC_NUMERIC 범주 설정 결정의 기 수 문자로 인식 nptr*;* 에 대 한 자세한 내용은 참조 하십시오. >setlocale.없이 함수는 _l 접미사 사용 하 여 현재 로케일입니다. _strtol_l및 _wcstol_l 동일 하지 않고 해당 함수는 _l 접미사는 대신 전달 된 로케일을 사용할 경우를 제외 하 고.자세한 내용은 로캘를 참조하십시오.

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

strtol 예상 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 사용할 수 있습니다.