strtol, wcstol, _strtol_l, _wcstol_l
문자열을 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 사용할 수 있습니다.
요구 사항
루틴 |
필수 헤더 |
---|---|
strtol |
<stdlib.h> |
wcstol |
<stdlib.h> 또는 <wchar.h> |
_strtol_l |
<stdlib.h> |
추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.
예제
예제를 보려면 strtod.
해당 .NET Framework 항목
참고 항목
참조
strtod, _strtod_l, wcstod, _wcstod_l