Paramètres régionauxLocale

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.Locale refers to country/region and language settings that you can use to customize your program. Certaines catégories dépendantes des paramètres régionaux incluent les formats d'affichage des dates et des valeurs monétaires.Some locale-dependent categories include the display formats for dates and monetary values. Pour plus d’informations, consultez Catégories de paramètres régionaux.For more information, see Locale Categories.

Utilisez la fonction setlocale pour modifier ou interroger certaines ou toutes les informations relatives aux paramètres régionaux du programme ou thread actif, tout en utilisant les fonctions sans le suffixe _l.Use the setlocale function to change or query some or all of the current program or thread locale information while using functions without the _l suffix. Les fonctions avec le suffixe _l utilisent le paramètre locale qui leur est passé pour ses paramètres régionaux, uniquement pendant l’exécution de cette fonction.The functions with the _l suffix will use the locale parameter passed in for their locale information during the execution of that specific function only. Pour créer des paramètres régionaux à utiliser avec une fonction dotée d’un suffixe _l, utilisez _create_locale.To create a locale for use with a function with a _l suffix, use _create_locale. Pour libérer ces paramètres régionaux, utilisez _free_locale.To free this locale, use _free_locale. Pour obtenir les paramètres régionaux actuels, utilisez _get_current_locale.To get the current locale, use _get_current_locale.

Utilisez _configthreadlocale pour déterminer si chaque thread possède ses propres paramètres régionaux, ou si tous les threads d’un programme partagent les mêmes paramètres régionaux.Use _configthreadlocale to control whether each thread has its own locale, or all threads in a program share the same locale. Pour plus d’informations, consultez Paramètres régionaux et pages de codes.For more information, see Locales and Code Pages.

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é »).More secure versions of the functions in the following table are available, indicated by the _s ("secure") suffix. Pour plus d'informations, consultez Security Features in the CRT.For more information, see Security Features in the CRT.

Routines dépendantes des paramètres régionauxLocale-Dependent Routines

RoutineRoutine UtilisezUse Dépendance du paramètre de catégorie setlocalesetlocale category setting dependence
atof, _atof_l, _wtof, _wtof_latof, _atof_l, _wtof, _wtof_l Convertir un caractère en valeur à virgule flottanteConvert character to floating-point value LC_NUMERICLC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_latoi, _atoi_l, _wtoi, _wtoi_l Convertir un caractère en valeur entièreConvert character to integer value LC_NUMERICLC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_l_atoi64, _atoi64_l, _wtoi64, _wtoi64_l Convertir un caractère en valeur entière 64 bitsConvert character to 64-bit integer value LC_NUMERICLC_NUMERIC
atol, _atol_l, _wtol, _wtol_latol, _atol_l, _wtol, _wtol_l Convertir un caractère en valeur de type longConvert character to long value LC_NUMERICLC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l Convertir un caractère en valeur de type long doubleConvert character to double-long value LC_NUMERICLC_NUMERIC
is (routines)is Routines Tester un entier donné pour une condition particulière.Test given integer for particular condition. LC_CTYPELC_CTYPE
isleadbyte, _isleadbyte_lisleadbyte, _isleadbyte_l Tester l'octet de têteTest for lead byte LC_CTYPELC_CTYPE
localeconvlocaleconv Lire les valeurs appropriées pour mettre en forme des quantités numériquesRead appropriate values for formatting numeric quantities LC_MONETARY, LC_NUMERIC
MB_CUR_MAXMB_CUR_MAX Longueur maximale en octets d'un caractère multioctet dans les paramètres régionaux actifs (macro définie dans STDLIB.H)Maximum length in bytes of any multibyte character in current locale (macro defined in STDLIB.H) LC_CTYPELC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l Copier un caractère multioctetCopy one multibyte character LC_CTYPELC_CTYPE
_mbclen, mblen, _mblen_l_mbclen, mblen, _mblen_l Valider et retourner le nombre d'octets dans un caractère multioctetValidate and return number of bytes in multibyte character LC_CTYPELC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_lstrlen, 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îneFor multibyte-character strings: validate each character in string; return string length LC_CTYPELC_CTYPE
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_lmbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l Convertir une séquence de caractères multioctets en une séquence correspondante de caractères largesConvert sequence of multibyte characters to corresponding sequence of wide characters LC_CTYPELC_CTYPE
mbtowc, _mbtowc_lmbtowc, _mbtowc_l Convertir un caractère multioctet en un caractère large correspondantConvert multibyte character to corresponding wide character LC_CTYPELC_CTYPE
Fonctions printfprintf functions Écrire la sortie mise en formeWrite formatted output LC_NUMERIC (détermine la sortie de caractères de base)LC_NUMERIC (determines radix character output)
Fonctions scanfscanf functions Lire l'entrée mise en formeRead formatted input LC_NUMERIC (détermine la reconnaissance des caractères de base)LC_NUMERIC (determines radix character recognition)
setlocale, _wsetlocalesetlocale, _wsetlocale Sélectionner les paramètres régionaux du programmeSelect locale for program Non applicableNot applicable
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_lstrcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l Comparer les caractères de deux chaînesCompare characters of two strings LC_COLLATELC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l Comparer deux chaînes sans tenir compte de la casseCompare two strings without regard to case LC_CTYPELC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l Comparer les caractères de deux chaînes (qui ne respectent pas la casse)Compare characters of two strings (case insensitive) LC_COLLATELC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l Comparer les n premiers caractères de deux chaînesCompare first n characters of two strings LC_COLLATELC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l Comparer les caractères de deux chaînes sans tenir compte de la casse.Compare characters of two strings without regard to case. LC_CTYPELC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l Comparer les n premiers caractères de deux chaînes (qui ne respectent pas la casse)Compare first n characters of two strings (case insensitive) LC_COLLATELC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_lstrftime, wcsftime, _strftime_l, _wcsftime_l Mettre en forme une valeur de date et d’heure en fonction de l’argument format fourniFormat date and time value according to supplied format argument LC_TIMELC_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_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 minusculesConvert, in place, each uppercase letter in given string to lowercase LC_CTYPELC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_lstrtod, _strtod_l, wcstod, _wcstod_l Convertir une chaîne de caractères en valeur doubleConvert character string to double value LC_NUMERIC (détermine la reconnaissance des caractères de base)LC_NUMERIC (determines radix character recognition)
strtol, wcstol, _strtol_l, _wcstol_lstrtol, wcstol, _strtol_l, _wcstol_l Convertir une chaîne de caractères en valeur longConvert character string to long value LC_NUMERIC (détermine la reconnaissance des caractères de base)LC_NUMERIC (determines radix character recognition)
strtoul, _strtoul_l, wcstoul, _wcstoul_lstrtoul, _strtoul_l, wcstoul, _wcstoul_l Convertir une chaîne de caractères en une valeur de type long non signéConvert character string to unsigned long value LC_NUMERIC (détermine la reconnaissance des caractères de base)LC_NUMERIC (determines radix character recognition)
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l_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 majusculesConvert, in place, each lowercase letter in string to uppercase LC_CTYPELC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_lstrxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l Transformer une chaîne dans un format compilé en respectant les paramètres régionauxTransform string into collated form according to locale LC_COLLATELC_COLLATE
tolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_ltolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l Convertir un caractère donné en un caractère minuscule correspondantConvert given character to corresponding lowercase character LC_CTYPELC_CTYPE
toupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_ltoupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l Convertir un caractère donné en une lettre majuscule correspondanteConvert given character to corresponding uppercase letter LC_CTYPELC_CTYPE
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_lwcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l Convertir une séquence de caractères larges en une séquence correspondante de caractères multioctetsConvert sequence of wide characters to corresponding sequence of multibyte characters LC_CTYPELC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_lwctomb, _wctomb_l,wctomb_s, _wctomb_s_l Convertir un caractère large en un caractère multioctet correspondantConvert wide character to corresponding multibyte character LC_CTYPELC_CTYPE

Notes

Pour les routines multioctets, la page de codes multioctets doit être équivalente aux paramètres régionaux définis avec setlocale.For multibyte routines, the multibyte code page must be equivalent to the locale set with setlocale. _setmbcp, avec l’argument _MB_CP_LOCALE, rend la page de codes multioctet identique à la page de codes setlocale._setmbcp, with an argument of _MB_CP_LOCALE makes the multibyte code page the same as the setlocale code page.

Voir aussiSee also

InternationalisationInternationalization
Routines du runtime C universel par catégorieUniversal C runtime routines by category