支持的 NLS 函数

国家语言支持 (NLS) 函数可帮助游戏支持与语言和区域相关的行为。在 XBOX 上,只有 WinNLS.h 中定义在 WINAPI_PARTITION_GAMES 分区下的 API 函数才可用。

标记为 DEPRECATED 的 API 在 GDK 上仍然可用,并遵循 Microsoft Docs 中记录的注意事项。请优先使用替代函数。

可用的函数

函数	状态	替代函数
`EnumSystemLocalesEx`
`FindNLSStringEx`
`FoldStringA`
`GetACP`
`GetCurrencyFormatEx`
`GetGeoInfoEx`
`GetLocaleInfoEx`
`GetNumberFormatEx`
`GetStringTypeA`
`GetStringTypeExA`
`GetThreadLocale`
`GetUserDefaultGeoName`
`GetUserDefaultLocaleName`
`GetUserPreferredUILanguages`	NOT SUPPORTED	始终返回 `en-US`
`IdnToAscii`
`IdnToUnicode`
`IsValidCodePage`
`IsValidLocaleName`
`LCIDToLocaleName`
`LCMapStringEx`
`LocaleNameToLCID`
`ResolveLocaleName`
`SetThreadLocale`
`CompareString`	DEPRECATED	`CompareStringEx`
`CompareStringA`	DEPRECATED	`CompareStringEx`
`EnumSystemLocalesA`	DEPRECATED	`EnumSystemLocalesEx`
`EnumSystemLocalesW`	DEPRECATED	`EnumSystemLocalesEx`
`FindNLSString`	DEPRECATED	`FindNLSStringEx`
`GetCPInfo`	DEPRECATED	使用 Unicode
`GetCPInfoExA`	DEPRECATED	使用 Unicode
`GetCPInfoExW`	DEPRECATED	使用 Unicode
`GetCurrencyFormatA`	DEPRECATED	`GetCurrencyFormatEx`
`GetCurrencyFormatW`	DEPRECATED	`GetCurrencyFormatEx`
`GetGeoInfoA`	DEPRECATED	`GetGeoInfoEx`
`GetGeoInfoW`	DEPRECATED	`GetGeoInfoEx`
`GetLocaleInfoA`	DEPRECATED	`GetLocaleInfoEx`
`GetLocaleInfoW`	DEPRECATED	`GetLocaleInfoEx`
`GetNumberFormatA`	DEPRECATED	`GetNumberFormatEx`
`GetNumberFormatW`	DEPRECATED	`GetNumberFormatEx`
`GetUserGeoID`	DEPRECATED	`GetUserDefaultLocaleName`
`LCMapStringA`	DEPRECATED	`LCMapStringEx`
`LCMapStringW`	DEPRECATED	`LCMapStringEx`

Game OS 的 NLS 函数不包含 Windows 拥有的完整语言学大小写映射表。排序规则与大小写操作无论区域设置如何,始终使用序数值。 请在本地化流程中执行文化敏感的大小写与排序操作,而不是在运行时进行。受影响的函数:

该列表并不详尽 —— 其他 Standard C++ Library 函数也可能依赖受影响的 API。