Chaînes relatives aux noms des paramètres régionaux UCRT, aux langues et au pays/à la région

Vous pouvez définir l’argument sur l’argument localesetlocale, _wsetlocaleet _create_locale_wcreate_locale les fonctions de plusieurs manières. Les paramètres régionaux peuvent être définis à l’aide des noms de paramètres régionaux, des langues, des codes pays/région et des pages de codes prises en charge par l’API NLS Windows. L’argument locale prend l’une des formes suivantes :

locale :: « locale-name »
 | « language[_country-region[.code-page]] »
 | ".page de codes »
 | "C"
 | ""
 | NULL

Le formulaire locale-name est une chaîne courte à la norme IETF, par exemple, en-US pour l’anglais (États-Unis) ou bs-Cyrl-BA pour le bosniaque (cyrillique, Bosnie-Herzégovine). Ces formulaires sont préférables. Pour obtenir une liste des noms de paramètres régionaux pris en charge par la version du système d’exploitation Windows, consultez la colonne Balise de langue de la table dans Appendix A: Product Behavior dans [MS-LCID] : référence d’identificateur de code de langue (LCID) Windows. Cette ressource répertorie le langage, le script, et les parties régionales des noms de paramètres régionaux pris en charge. Pour plus d’informations sur les noms de paramètres régionaux pris en charge qui ont des ordres de tri non par défaut, consultez la colonne Nom des paramètres régionaux dans les identificateurs d’ordre de tri. Sous Windows 10 ou version ultérieure, les noms de paramètres régionaux qui correspondent aux balises de langue BCP-47 valides sont autorisés. Par exemple, jp-US il s’agit d’une balise BCP-47 valide, mais elle est efficace uniquement US pour les fonctionnalités de paramètres régionaux.

Langue[_country-region[.Le formulaire code-page]] est stocké dans le paramètre de paramètres régionaux d’une catégorie lorsqu’une chaîne de langue, ou une chaîne de langue et une chaîne de pays ou de région, est utilisée pour créer les paramètres régionaux. L’ensemble de chaînes de langue prises en charge est décrit dans les chaînes de langue, et la liste des chaînes de pays et de région prises en charge est répertoriée dans les chaînes Pays/Région. Si la langue spécifiée n’est pas associée au pays ou à la région spécifié, la langue par défaut du pays ou de la région spécifié est stockée dans le paramètre de paramètres régionaux. Nous ne recommandons pas ce formulaire pour les chaînes de paramètres régionaux incorporées dans le code ou sérialisées au stockage : ces chaînes sont plus susceptibles d’être modifiées par une mise à jour du système d’exploitation que le formulaire de nom des paramètres régionaux.

La page code-page est la page de codes ANSI/OEM qui est associée aux paramètres régionaux. La page de codes est déterminée pour vous lorsque vous spécifiez des paramètres régionaux seulement par langage ou par langage et pays/région. La valeur spéciale .ACP spécifie la page de codes ANSI pour le pays/la région. La valeur spéciale .OCP spécifie la page de codes OEM pour le pays/la région. Par exemple, si vous spécifiez "Greek_Greece.ACP" comme paramètres régionaux, les paramètres régionaux sont stockés en tant que Greek_Greece.1253 (page de codes ANSI pour le grec) et si vous spécifiez "Greek_Greece.OCP" comme paramètres régionaux, il est stocké en tant que Greek_Greece.737 (page de codes OEM pour le grec). Pour plus d’informations sur les pages de codes, consultez Pages de code. Pour obtenir la liste des pages de codes prises en charge sur Windows, consultez les identificateurs de page de codes.

Si vous utilisez uniquement la page de codes pour spécifier les paramètres régionaux, la langue et le pays/région par défaut de l’utilisateur comme indiqué sont GetUserDefaultLocaleName utilisés. Par exemple, si vous spécifiez ".1254" (turc ANSI) en tant que paramètres régionaux pour un utilisateur configuré pour l’anglais (États-Unis), les paramètres régionaux stockés sont English_United States.1254. Nous ne recommandons pas ce formulaire, car cela peut entraîner un comportement incohérent.

Valeur locale d’argument de C spécifie l’environnement minimal conforme ANSI pour la traduction C. Les paramètres régionaux C supposent que chaque type de données char est 1 octet et que sa valeur est toujours inférieure à 256. Si locale pointe vers une chaîne vide, les paramètres régionaux sont donnés par l'environnement défini lors de l'implémentation.

Spécifiez toutes les catégories de paramètres régionaux en même temps pour les fonctions setlocale et _wsetlocale à l'aide de la catégorie LC_ALL . Les catégories peuvent toutes être définies aux mêmes paramètres régionaux, ou vous pouvez définir chaque catégorie individuellement en utilisant un argument de paramètres régionaux qui se présente comme suit :

LC-ALL-specifier :: locale
 | [LC_COLLATE=locale][;LC_CTYPE=locale][;LC_MONETARY=locale][;LC_NUMERIC=locale][;LC_TIME=locale]

Spécifiez plusieurs types de catégories, séparés par des points-virgules. Les types de catégorie qui ne sont pas spécifiés utilisent le paramètre de paramètres régionaux actuel. Par exemple, cet extrait de code attribue à toutes les catégories les paramètres régionaux actuels de-DE, puis définit les catégories LC_MONETARY sur en-GB et LC_TIME sur es-ES :

_wsetlocale(LC_ALL, L"de-DE");
_wsetlocale(LC_ALL, L"LC_MONETARY=en-GB;LC_TIME=es-ES");

Prise en charge de UTF-8

La prise en charge de UTF-8 peut être activée à l’aide de la page de codes UTF-8 dans votre chaîne de paramètres régionaux. Pour plus d’informations, consultez la section de support UTF-8 de setlocale.

Voir aussi

Informations de référence sur la bibliothèque Runtime C
_get_current_locale
setlocale, _wsetlocale
_create_locale, _wcreate_locale
Chaînes de langue
Chaînes pays/région