> ## 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.

# Fonctions NLS prises en charge

> Consultez les fonctions NLS (National Language Support) disponibles sous WINAPI_PARTITION_GAMES dans le GDK, avec les mises en garde et les notes d'utilisation propres au système d'exploitation de jeu XBOX.

Les fonctions NLS (National Language Support) aident les titres à prendre en charge les comportements propres à une langue et à des paramètres régionaux. Seules les fonctions d'API définies sous la partition `WINAPI_PARTITION_GAMES` dans `WinNLS.h` sont disponibles sur XBOX.

<Note>
  Les API marquées **DÉCONSEILLÉE** fonctionnent toujours avec le GDK, sous réserve des mises en garde documentées sur Microsoft Docs. Privilégiez les fonctions de remplacement.
</Note>

## Fonctions disponibles

| Fonction | État | Remplacement |
| - | - | - |
| `EnumSystemLocalesEx` | | |
| `FindNLSStringEx` | | |
| `FoldStringA` | | |
| `GetACP` | | |
| `GetCurrencyFormatEx` | | |
| `GetGeoInfoEx` | | |
| `GetLocaleInfoEx` | | |
| `GetNumberFormatEx` | | |
| `GetStringTypeA` | | |
| `GetStringTypeExA` | | |
| `GetThreadLocale` | | |
| `GetUserDefaultGeoName` | | |
| `GetUserDefaultLocaleName` | | |
| `GetUserPreferredUILanguages` | NON PRISE EN CHARGE | Retourne toujours `en-US` |
| `IdnToAscii` | | |
| `IdnToUnicode` | | |
| `IsValidCodePage` | | |
| `IsValidLocaleName` | | |
| `LCIDToLocaleName` | | |
| `LCMapStringEx` | | |
| `LocaleNameToLCID` | | |
| `ResolveLocaleName` | | |
| `SetThreadLocale` | | |
| `CompareString` | DÉCONSEILLÉE | `CompareStringEx` |
| `CompareStringA` | DÉCONSEILLÉE | `CompareStringEx` |
| `EnumSystemLocalesA` | DÉCONSEILLÉE | `EnumSystemLocalesEx` |
| `EnumSystemLocalesW` | DÉCONSEILLÉE | `EnumSystemLocalesEx` |
| `FindNLSString` | DÉCONSEILLÉE | `FindNLSStringEx` |
| `GetCPInfo` | DÉCONSEILLÉE | Utiliser Unicode |
| `GetCPInfoExA` | DÉCONSEILLÉE | Utiliser Unicode |
| `GetCPInfoExW` | DÉCONSEILLÉE | Utiliser Unicode |
| `GetCurrencyFormatA` | DÉCONSEILLÉE | `GetCurrencyFormatEx` |
| `GetCurrencyFormatW` | DÉCONSEILLÉE | `GetCurrencyFormatEx` |
| `GetGeoInfoA` | DÉCONSEILLÉE | `GetGeoInfoEx` |
| `GetGeoInfoW` | DÉCONSEILLÉE | `GetGeoInfoEx` |
| `GetLocaleInfoA` | DÉCONSEILLÉE | `GetLocaleInfoEx` |
| `GetLocaleInfoW` | DÉCONSEILLÉE | `GetLocaleInfoEx` |
| `GetNumberFormatA` | DÉCONSEILLÉE | `GetNumberFormatEx` |
| `GetNumberFormatW` | DÉCONSEILLÉE | `GetNumberFormatEx` |
| `GetUserGeoID` | DÉCONSEILLÉE | `GetUserDefaultLocaleName` |
| `LCMapStringA` | DÉCONSEILLÉE | `LCMapStringEx` |
| `LCMapStringW` | DÉCONSEILLÉE | `LCMapStringEx` |

## Notes sur le comportement du système d'exploitation de jeu

Les fonctions NLS du système d'exploitation de jeu (Game OS) n'incluent **pas** les tables linguistiques complètes de gestion de la casse dont dispose Windows. Les opérations de classement et de casse utilisent toujours des valeurs **ordinales**, quels que soient les paramètres régionaux.

**Effectuez la gestion de la casse et le tri sensibles à la culture dans le cadre de votre processus de localisation**, et non à l'exécution.

Fonctions touchées :

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

### Classement

| De base | Large | Multioctet |
| - | - | - |
| `std::collate` | | |
| `strcoll` | `wcscoll` | `_mbscoll` |
| `_stricoll` | `_wcsicoll` | `_mbsicoll` |
| `_strncoll` | `_wcsncoll` | `_mbsncoll` |
| `_strnicoll` | `_wcsnicoll` | `_mbsnicoll` |

### Conversion en majuscules

| De base | Variante | Variante large |
| - | - | - |
| `std::toupper` | `toupper` | `towupper` |
| `_toupper` | `_toupper_l` | `_towupper_l` |
| `std::isupper` | `isupper` | `iswupper` |
| `_isupper_l` | `_iswupper_l` | |

### Conversion en minuscules

| De base | Variante | Variante large |
| - | - | - |
| `std::tolower` | `tolower` | `towlower` |
| `_tolower` | `_tolower_l` | `_towlower_l` |
| `std::islower` | `islower` | `iswlower` |
| `_islower_l` | `_iswlower_l` | |

<Note>
  Cette liste n'est pas exhaustive : d'autres fonctions de la bibliothèque standard C++ peuvent dépendre des API touchées.
</Note>

## Documentation des API connexes

* [Référence des fonctionnalités XGameRuntime](/fr-CA/reference/system/xgameruntimefeature/xgameruntimefeature_members) : surface GDK relative aux paramètres régionaux + à la région, complémentaire aux fonctions NLS


## Related topics

- [Vue d'ensemble de la localisation et de la mondialisation](/fr-CA/build/game-principles/localization.md)
- [Prise en charge d'Address Sanitizer pour XBOX](/fr-CA/tools/tools-console/visualstudio/address-sanitizer-support.md)
- [Prise en charge des jeux en tant que service (GaaS)](/fr-CA/build/core-features/common/packaging/supporting-games-as-a-service.md)
- [Prise en charge multiplateforme de XUser](/fr-CA/build/core-features/common/user/xuser-crossplatform.md)
- [Notes de prise en charge de Visual Studio 2019](/fr-CA/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)