지원되는 NLS 함수
NLS(국가별 언어 지원) 함수는 응용 프로그램에서 전 세계 사용자의 다양한 언어 및 로캘 관련 요구 사항을 지원할 수 있도록 도와줍니다.
WinNLS.h 헤더 파일의 WINAPI_PARTITION_GAMES 파티션 아래에 정의된 API 함수만 Xbox에서 사용할 수 있습니다. 다음 기능은 현재 WinNls.h 헤더 파일을 통해 사용할 수 있습니다.
참고 항목
"사용되지 않음"으로 표시된 API는 Microsoft Docs에 문서화된 주의 사항이 적용된 상태로 Microsoft GDK(게임 개발 키트)와 작동합니다. 그러나 대체 API를 사용하는 것이 더욱더 좋습니다.
| 함수 | 상태 | 대체 함수 |
|---|---|---|
EnumSystemLocalesEx |
||
FindNLSStringEx |
||
FoldStringA |
||
GetACP |
||
GetCurrencyFormatEx |
||
GetGeoInfoEx |
||
GetLocaleInfoEx |
||
GetNumberFormatEx |
||
GetStringTypeA |
||
GetStringTypeExA |
||
GetThreadLocalevoid); |
||
GetUserDefaultGeoName |
||
GetUserDefaultLocaleName |
||
GetUserPreferredUILanguages |
지원되지 않음 | 항상 en-US 반환 |
IdnToAscii |
||
IdnToUnicode |
||
IsValidCodePage |
||
IsValidLocaleName |
||
LCIDToLocaleName |
||
LCMapStringEx |
||
LocaleNameToLCID |
||
ResolveLocaleName |
||
SetThreadLocale |
||
CompareString |
사용되지 않음 | CompareStringEx |
CompareStringA |
사용되지 않음 | CompareStringEx |
EnumSystemLocalesA |
사용되지 않음 | EnumSystemLocalesEx |
EnumSystemLocalesW |
사용되지 않음 | EnumSystemLocalesEx |
FindNLSString |
사용되지 않음 | FindNLSStringEx |
GetCPInfo |
사용되지 않음 | 유니코드 사용 |
GetCPInfoExA |
사용되지 않음 | 유니코드 사용 |
GetCPInfoExW |
사용되지 않음 | 유니코드 사용 |
GetCurrencyFormatA |
사용되지 않음 | GetCurrencyFormatEx |
GetCurrencyFormatW |
사용되지 않음 | GetCurrencyFormatEx |
GetGeoInfoA |
사용되지 않음 | GetGeoInfoEx |
GetGeoInfoW |
사용되지 않음 | GetGeoInfoEx |
GetLocaleInfoA |
사용되지 않음 | GetLocaleInfoEx |
GetLocaleInfoW |
사용되지 않음 | GetLocaleInfoEx |
GetNumberFormatA |
사용되지 않음 | GetNumberFormatEx |
GetNumberFormatW |
사용되지 않음 | GetNumberFormatEx |
GetUserGeoID |
사용되지 않음 | GetUserDefaultLocaleName |
LCMapStringA |
사용되지 않음 | LCMapStringEx |
LCMapStringW |
사용되지 않음 | LCMapStringEx |
Xbox Game OS용 기능 노트
NLS 기능의 Game OS 버전은 PC에서 사용할 수 있는 전체 기능을 지원하지 않습니다. 특히 Game OS 이미지에는 Windows에 있는 대소문자 로캘 데이터 테이블이 포함되어 있지 않습니다. 따라서 데이터 정렬 및 케이싱 작업은 로캘 설정에 관계없이 항상 Ordinal 값을 사용하여 계산됩니다.
일반적인 권장 사항은 Xbox에서 이를 처리하기 위해 런타임 API에 의존하지 않고 지역화 프로세스의 일부로 문화권 구분 대/소문자 및 정렬을 수행하는 것입니다.
이는 다음 기능의 동작에 영향을 미칩니다.
| NLS |
|---|
| LCMapStringEx |
| CompareStringEx |
| CompareString |
| CompareStringA |
| Collation | ||
|---|---|---|
| std::collate | ||
| strcoll | wcscoll | _mbscoll |
| _stricoll | _wcsicoll | _mbsicoll |
| _strncoll | _wcsncoll | _mbsncoll |
| _strnicoll | _wcsnicoll | _mbsnicoll |
| 대문자 | ||
|---|---|---|
| std::toupper | toupper | towupper |
| _toupper | _toupper_l | _towupper_l |
| std::isupper | isupper | iswupper |
| _isupper_l | _iswupper_l |
| 소문자 | ||
|---|---|---|
| std::toupper | toupper | towupper |
| _toupper | _toupper_l | _towupper_l |
| std::islower | islower | iswlower |
| _islower_l | _iswlower_l |
참고 항목
표준 C++ 라이브러리의 일부 다른 함수는 구현을 위해 영향을 받는 함수에 의존할 수 있으므로 위 목록은 완전하지 않습니다.