Paramètres régionaux

  • Article

Les paramètres régionaux font référence aux paramètres de pays/région et de langue que vous pouvez utiliser pour personnaliser votre programme. Certaines catégories dépendantes des paramètres régionaux incluent les formats d'affichage des dates et des valeurs monétaires. Pour plus d’informations, consultez les catégories de paramètres régionaux.

Utilisez la setlocale fonction pour modifier ou interroger une partie ou l’ensemble des informations de paramètres régionaux du programme ou du thread en cours lors de l’utilisation de fonctions sans le _l suffixe. Les fonctions avec le suffixe _l utilisent les paramètres régionaux passés pour leurs informations relatives aux paramètres régionaux pendant l'exécution de cette fonction spécifique uniquement. Pour créer des paramètres régionaux à utiliser avec une fonction avec un _l suffixe, utilisez _create_locale. Pour libérer ces paramètres régionaux, utilisez _free_locale. Pour obtenir les paramètres régionaux actuels, utilisez _get_current_locale.

Permet _configthreadlocale de contrôler si chaque thread a ses propres paramètres régionaux ou tous les threads d’un programme partagent les mêmes paramètres régionaux. Pour plus d’informations, consultez Paramètres régionaux et pages de codes.

Des versions plus sécurisées des fonctions contenues dans le tableau suivant sont disponibles ; elles sont indiquées par le suffixe _s ("sécurisé"). Pour plus d’informations, consultez Fonctionnalités de sécurité dans le CRT.

Routines dépendantes des paramètres régionaux

Routine Utiliser Dépendance de la catégorie setlocale
atof, , _atof_l_wtof, ,_wtof_l Convertir un caractère en valeur à virgule flottante LC_NUMERIC
atoi, , _atoi_l_wtoi, ,_wtoi_l Convertir un caractère en valeur entière LC_NUMERIC
_atoi64, , _atoi64_l_wtoi64, ,_wtoi64_l Convertir un caractère en valeur entière 64 bits LC_NUMERIC
atol, , _atol_l_wtol, ,_wtol_l Convertir un caractère en valeur de type long LC_NUMERIC
_atodbl, , _atodbl_l, _atoldbl_l_atoldbl, , _atoflt_atoflt_l Convertir un caractère en valeur de type long double LC_NUMERIC
Routines is, isw Tester un entier donné pour une condition particulière. LC_CTYPE
isleadbyte, _isleadbyte_l Tester l'octet de tête LC_CTYPE
localeconv Lire les valeurs appropriées pour mettre en forme des quantités numériques LC_MONETARY, LC_NUMERIC
MB_CUR_MAX Longueur maximale en octets d’un caractère multioctet dans les paramètres régionaux actuels (macro définie dans STDLIB.H) LC_CTYPE
_mbccpy, ,_mbccpy_l_mbccpy_s,_mbccpy_s_l Copier un caractère multioctet LC_CTYPE
_mbclen, , mblen_mblen_l Valider et retourner le nombre d'octets dans un caractère multioctet LC_CTYPE
strlen, , wcslen, _mbslen_l_mbslen, , _mbstrlen_mbstrlen_l Pour les chaînes de caractères multioctets : valider chaque caractère de la chaîne ; retourner la longueur de la chaîne LC_CTYPE
mbstowcs, ,_mbstowcs_lmbstowcs_s,_mbstowcs_s_l Convertir une séquence de caractères multioctets en une séquence correspondante de caractères larges LC_CTYPE
mbtowc, _mbtowc_l Convertir un caractère multioctet en un caractère large correspondant LC_CTYPE
fonctionsprintf Écrire la sortie mise en forme LC_NUMERIC (détermine la sortie de caractères de base)
fonctionsscanf Lire l'entrée mise en forme LC_NUMERIC (détermine la reconnaissance de caractères de base)
setlocale, _wsetlocale Sélectionner les paramètres régionaux du programme Non applicable
strcoll, , wcscoll, _strcoll_l_mbscoll, , _wcscoll_l_mbscoll_l Comparer les caractères de deux chaînes LC_COLLATE
_stricmp, , _wcsicmp, _stricmp_l_mbsicmp, , _wcsicmp_l_mbsicmp_l Comparer deux chaînes sans tenir compte de la casse LC_CTYPE
_stricoll, , _wcsicoll, _stricoll_l_mbsicoll, , _wcsicoll_l_mbsicoll_l Comparer les caractères de deux chaînes (qui ne respectent pas la casse) LC_COLLATE
_strncoll, , _wcsncoll, _strncoll_l_mbsncoll, , _wcsncoll_l_mbsncoll_l Comparer les premiers caractères n de deux chaînes LC_COLLATE
_strnicmp, , _wcsnicmp, _strnicmp_l_mbsnicmp, , _wcsnicmp_l_mbsnicmp_l Comparer les caractères de deux chaînes sans tenir compte de la casse. LC_CTYPE
_strnicoll, , _wcsnicoll, _strnicoll_l_mbsnicoll, , _wcsnicoll_l_mbsnicoll_l Comparer les premiers caractères n de deux chaînes (qui ne respectent pas la casse) LC_COLLATE
strftime, , wcsftime_strftime_l, ,_wcsftime_l Mettre en forme une valeur de date et d'heure en fonction de l'argument format fourni LC_TIME
_strlwr, , , , , _mbslwr_l_strlwr_s_l_mbslwr_s_l_wcslwr_s_mbslwr_s_wcslwr_l_strlwr_s_strlwr_l_mbslwr_wcslwr_wcslwr_s_l Convertir, sur place, chaque lettre majuscule d'une chaîne donnée en minuscules LC_CTYPE
strtod, , _strtod_lwcstod, ,_wcstod_l Convertir une chaîne de caractères en une valeur double LC_NUMERIC (détermine la reconnaissance de caractères de base)
strtol, , wcstol_strtol_l, ,_wcstol_l Convertir une chaîne de caractères en une valeur long LC_NUMERIC (détermine la reconnaissance de caractères de base)
strtoul, , _strtoul_lwcstoul, ,_wcstoul_l Convertir une chaîne de caractères en une valeur de type long non signé LC_NUMERIC (détermine la reconnaissance de caractères de base)
_strupr, , , , , _wcsupr_strupr_s_l_mbsupr_s_l_wcsupr_s_mbsupr_s_wcsupr_l_strupr_s_mbsupr_l_mbsupr_strupr_l_wcsupr_s_l Convertir, sur place, chaque lettre minuscule d'une chaîne en majuscules LC_CTYPE
strxfrm, , wcsxfrm_strxfrm_l, ,_wcsxfrm_l Transformer une chaîne dans un format compilé en respectant les paramètres régionaux LC_COLLATE
tolower, , _tolower, towlower, _towlower_l_mbctolower_tolower_l_mbctolower_l, , _mbctoupper_mbctoupper_l Convertir un caractère donné en un caractère minuscule correspondant LC_CTYPE
toupper, , _toupper, towupper, _towupper_l_mbctolower_toupper_l_mbctolower_l, , _mbctoupper_mbctoupper_l Convertir un caractère donné en une lettre majuscule correspondante LC_CTYPE
wcstombs, ,_wcstombs_lwcstombs_s,_wcstombs_s_l Convertir une séquence de caractères larges en une séquence correspondante de caractères multioctets LC_CTYPE
wctomb, ,_wctomb_lwctomb_s,_wctomb_s_l Convertir un caractère large en un caractère multioctet correspondant LC_CTYPE

Remarque

Pour les routines multioctets, la page de codes multioctets doit être équivalente aux paramètres régionaux définis avec setlocale. _setmbcp, avec un argument permettant de rendre la page de _MB_CP_LOCALE codes multioctet identique à la page de setlocale codes.

Voir aussi

Internationalisation
Routines du runtime C universel par catégorie