Paramètres régionaux
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 | Utilisation | 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 , _atoldbl_l , _atoflt , _atoflt_l |
Convertir un caractère en valeur de type long double | LC_NUMERIC |
is , isw routines |
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 , _mbslen_l , _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_l ,mbstowcs_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 , _mbscoll , _strcoll_l , _wcscoll_l , _mbscoll_l |
Comparer les caractères de deux chaînes | LC_COLLATE |
_stricmp , _wcsicmp , _mbsicmp , _stricmp_l , _wcsicmp_l , _mbsicmp_l |
Comparer deux chaînes sans tenir compte de la casse | LC_CTYPE |
_stricoll , _wcsicoll , _mbsicoll , _stricoll_l , _wcsicoll_l , _mbsicoll_l |
Comparer les caractères de deux chaînes (qui ne respectent pas la casse) | LC_COLLATE |
_strncoll , _wcsncoll , _mbsncoll , _strncoll_l , _wcsncoll_l , _mbsncoll_l |
Comparer les premiers caractères n de deux chaînes |
LC_COLLATE |
_strnicmp , _wcsnicmp , _mbsnicmp , _strnicmp_l , _wcsnicmp_l , _mbsnicmp_l |
Comparer les caractères de deux chaînes sans tenir compte de la casse. | LC_CTYPE |
_strnicoll , _wcsnicoll , _mbsnicoll , _strnicoll_l , _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 , _wcslwr , _mbslwr , _strlwr_l , _wcslwr_l , _mbslwr_l ,_strlwr_s , _strlwr_s_l , _mbslwr_s , _mbslwr_s_l , _wcslwr_s , _wcslwr_s_l |
Convertir, sur place, chaque lettre majuscule d'une chaîne donnée en minuscules | LC_CTYPE |
strtod , _strtod_l , wcstod , _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_l , wcstoul , _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 , _strupr_l , _mbsupr , _mbsupr_l , _wcsupr_l , _wcsupr ,_strupr_s , _strupr_s_l , _mbsupr_s , _mbsupr_s_l , _wcsupr_s , _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 , _tolower_l , _towlower_l ,_mbctolower , _mbctolower_l , _mbctoupper , _mbctoupper_l |
Convertir un caractère donné en un caractère minuscule correspondant | LC_CTYPE |
toupper , _toupper , towupper , _toupper_l , _towupper_l ,_mbctolower , _mbctolower_l , _mbctoupper , _mbctoupper_l |
Convertir un caractère donné en une lettre majuscule correspondante | LC_CTYPE |
wcstombs , _wcstombs_l ,wcstombs_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_l ,wctomb_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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : pendant toute l’année 2024, nous allons éliminer progressivement Problèmes GitHub comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, voir :Soumettre et afficher des commentaires pour