> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Funciones de NLS compatibles

> Consulte las funciones de compatibilidad con idiomas nacionales (NLS) disponibles en WINAPI_PARTITION_GAMES en el GDK, con advertencias y notas de uso para el Game OS de XBOX.

Las funciones de compatibilidad con idiomas nacionales (NLS) ayudan a los títulos a admitir comportamientos específicos del idioma y la configuración regional. En XBOX solo están disponibles las funciones de API definidas en la partición `WINAPI_PARTITION_GAMES` de `WinNLS.h`.

> [!NOTE]
>
> Las API marcadas como **DEPRECATED** siguen funcionando en el GDK con las advertencias documentadas en Microsoft Docs. Es preferible usar las funciones de reemplazo.

## Funciones disponibles

| Función | Estado | Reemplazo |
| - | - | - |
| `EnumSystemLocalesEx` | | |
| `FindNLSStringEx` | | |
| `FoldStringA` | | |
| `GetACP` | | |
| `GetCurrencyFormatEx` | | |
| `GetGeoInfoEx` | | |
| `GetLocaleInfoEx` | | |
| `GetNumberFormatEx` | | |
| `GetStringTypeA` | | |
| `GetStringTypeExA` | | |
| `GetThreadLocale` | | |
| `GetUserDefaultGeoName` | | |
| `GetUserDefaultLocaleName` | | |
| `GetUserPreferredUILanguages` | NOT SUPPORTED | Siempre devuelve `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 | Use Unicode |
| `GetCPInfoExA` | DEPRECATED | Use Unicode |
| `GetCPInfoExW` | DEPRECATED | Use 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` |

## Notas de comportamiento del Game OS

Las funciones de NLS del Game OS **no** incluyen las tablas completas de conversión lingüística de mayúsculas y minúsculas que tiene Windows. Las operaciones de intercalación y de conversión de mayúsculas y minúsculas siempre usan valores **ordinales**, independientemente de la configuración regional.

**Realice la conversión de mayúsculas y minúsculas y la ordenación sensibles a la cultura como parte de su proceso de localización**, no en tiempo de ejecución.

Funciones afectadas:

| NLS |
| - |
| `LCMapStringEx` |
| `CompareStringEx` |
| `CompareString` |
| `CompareStringA` |

### Intercalación

| Base | Ancha | Multibyte |
| - | - | - |
| `std::collate` | | |
| `strcoll` | `wcscoll` | `_mbscoll` |
| `_stricoll` | `_wcsicoll` | `_mbsicoll` |
| `_strncoll` | `_wcsncoll` | `_mbsncoll` |
| `_strnicoll` | `_wcsnicoll` | `_mbsnicoll` |

### Conversión a mayúsculas

| Base | Variante | Variante ancha |
| - | - | - |
| `std::toupper` | `toupper` | `towupper` |
| `_toupper` | `_toupper_l` | `_towupper_l` |
| `std::isupper` | `isupper` | `iswupper` |
| `_isupper_l` | `_iswupper_l` | |

### Conversión a minúsculas

| Base | Variante | Variante ancha |
| - | - | - |
| `std::tolower` | `tolower` | `towlower` |
| `_tolower` | `_tolower_l` | `_towlower_l` |
| `std::islower` | `islower` | `iswlower` |
| `_islower_l` | `_iswlower_l` | |

> [!NOTE]
>
> Esta lista no es exhaustiva: otras funciones de la biblioteca estándar de C++ podrían depender de las API afectadas.

## Documentación de API relacionada

* [Referencia de características de XGameRuntime](https://docs.xbox.com/es/reference/system/xgameruntimefeature/xgameruntimefeature_members.md): superficie del GDK de configuración regional + región que complementa NLS


## Related topics

- [Localización de Economy v2](https://docs.xbox.com/es/build/game-principles/localization.md)
- [Uso de Clang con Microsoft Game Development Kit (GDK) para consolas](https://docs.xbox.com/es/tools/tools-console/visualstudio/vs-clang.md)
- [Tabla de funciones intrínsecas](https://docs.xbox.com/es/tools/tools-console/visualstudio/table-of-intrinsics.md)
- [Etiquetas de funciones de accesibilidad](https://docs.xbox.com/es/build/game-principles/accessibility/accessibility-feature-tags.md)
- [Llamadas a las API compatibles con la nube](https://docs.xbox.com/es/build/core-features/common/game-streaming/game-streaming-am-i-streaming.md)