> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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 sistema operativo de juegos 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.
</Note>

## 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 sistema operativo de juegos

Las funciones de NLS del sistema operativo de juegos **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.
</Note>

## Documentación de API relacionada

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


## Related topics

- [Información general sobre localización y globalización](/es/build/game-principles/localization.md)
- [Uso de Clang/LLVM con el GDK para consolas](/es/tools/tools-console/visualstudio/vs-clang.md)
- [Etiquetas de funciones de accesibilidad](/es/build/game-principles/accessibility/accessibility-feature-tags.md)
- [Llamadas a las API compatibles con la nube](/es/build/core-features/common/game-streaming/game-streaming-am-i-streaming.md)
- [Tabla de funciones intrínsecas](/es/tools/tools-console/visualstudio/table-of-intrinsics.md)