StrToInt64ExW 함수(shlwapi.h)

아티클
03/02/2024

10진수 또는 16진수 값을 나타내는 문자열을 64비트 정수로 변환합니다.

구문

BOOL StrToInt64ExW(
  [in]  PCWSTR     pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

매개 변수

[in] pszString

형식: PCTSTR

변환할 null로 끝나는 문자열에 대한 포인터입니다. 유효한 형식의 문자열에 대한 자세한 내용은 설명 섹션을 참조하세요.

dwFlags

형식: STIF_FLAGS

pszString을 64비트 정수로 변환하기 위해 구문 분석하는 방법을 지정하는 다음 값 중 하나입니다.

STIF_DEFAULT

pszString의 문자열에는 10진수 값의 표현이 포함됩니다.

STIF_SUPPORT_HEX

pszString의 문자열에는 10진수 또는 16진수 값의 표현이 포함됩니다. 16진수 표현에서 문자 A-F는 대/소문자를 구분하지 않습니다.

[out] pllRet

형식: LONGLONG*

변환된 문자열의 64비트 정수 값을 받는 LONGLONG 형식의 변수에 대한 포인터입니다. instance 경우 문자열 "123"의 경우 이 값이 가리키는 정수는 값 123을 받습니다.

이 함수가 FALSE를 반환하면 이 값은 정의되지 않습니다.

반환된 값이 너무 커서 LONGLONG 형식의 변수에 포함할 수 없는 경우 이 매개 변수에는 값의 64개의 하위 비트가 포함됩니다. 그 이상의 모든 고차 비트는 손실됩니다.

반환 값

형식: BOOL

문자열이 변환되면 TRUE 를 반환합니다. 그렇지 않으면 FALSE입니다.

설명

pszString 매개 변수가 가리키는 문자열은 성공적으로 구문 분석할 다음 양식 중 하나가 있어야 합니다.

이 양식은 두 플래그 아래의 10진수 값으로 허용됩니다. ''' 구문(선택적 공백)(선택적 기호)(10진수 하나 이상) '''
이러한 양식은 STIF_SUPPORT_HEX 플래그가 전달될 때 16진수 값에 필요합니다. ''' 구문(선택적 공백)(선택적 기호)0x(하나 이상의 16진수 숫자) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

선택적 기호는 '-' 또는 '+' 문자일 수 있습니다. 생략하면 기호가 양수로 간주됩니다.

참고 값이 16진수로 구문 분석되면 '-' 문자인 경우에도 선택적 기호는 무시됩니다. 예를 들어 문자열 "-0x1"은 -1이 아닌 1로 구문 분석됩니다.

pszString에서 가리키는 문자열에 잘못된 문자가 포함된 경우 해당 문자는 변환할 문자열의 끝으로 간주되고 나머지는 무시됩니다. instance 경우 잘못된 16진수 문자열 "0x00am123"이면 StrToInt64Ex는 "0x00a"만 인식하고 정수 값 10으로 변환하고 TRUE를 반환합니다.

pllRet이 NULL이면 변환을 수행하지 않더라도 문자열을 변환할 수 있는 경우 함수는 TRUE를 반환합니다.

참고

shlwapi.h 헤더는 STRToInt64Ex를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 5.0 이상)

다음을 통해 공유