_strtoui64, _wcstoui64, _strtoui64_l, _wcstoui64_l

아티클
02/21/2013

문자열에서 부호 없는 변환 __int64 값입니다.

unsigned __int64 _strtoui64(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned __int64 _wcstoui64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned __int64 _strtoui64_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned __int64 _wcstoui64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

매개 변수

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

반환 값

_strtoui64문자열에 표시 되는 값을 반환 합니다. nptr표현에서 오버플로가 발생 합니다 경우에 반환 경우 제외 하 고, _UI64_MAX._strtoui64변환할 수 있습니다 경우 0을 반환 합니다.

_UI64_MAX영역에서 정의 됩니다.H.

경우 nptr 입니다 NULL 또는 base 0이 및 2 되거나 36, 보다 큰 errno 로 설정 됩니다 EINVAL.

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

설명

The _strtoui64function converts nptr to an unsigned __int64._wcstoui64와이드 문자 버전입니다 _strtoui64. 해당 nptr 인수는 와이드 문자열입니다.그렇지 않으면 이러한 함수를 동일 하 게 동작합니다.

두 함수 모두 중지 읽기 nptr 는 숫자의 일부로 인식할 수 없는 첫 번째 문자입니다.종료 null 문자를 수 있습니다 또는 첫 번째 숫자 보다 크거나 수 있습니다 base.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_tcstoui64	_strtoui64	_strtoui64	_wstrtoui64
_tcstoui64_l	_strtoui64_l	_strtoui64_l	_wstrtoui64_l

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

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

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

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

A whitespace 는 무시 됩니다; 공백, 탭 문자 중 구성 될 수 있습니다 digits 10 진수 숫자입니다.이 양식에 맞지 않는 첫 번째 문자 검색을 중지 합니다.경우 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 사용할 수 있습니다.

요구 사항

루틴	필수 헤더
_strtoui64	<stdlib.h>
_wcstoui64	<stdlib.h> 또는 <wchar.h>
_strtoui64_l	<stdlib.h>
_wcstoui64_l	<stdlib.h> 또는 <wchar.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// crt_strtoui64.c
#include <stdio.h>

unsigned __int64 atoui64(const char *szUnsignedInt) {
   return _strtoui64(szUnsignedInt, NULL, 10);
}

int main() {
   unsigned __int64 u = atoui64("18446744073709551615");
   printf( "u = %I64u\n", u );
}