Paramètres régionaux

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

Utilisez la fonction setlocale afin de modifier ou d'envoyer une requête à certains ou tout les programmes en cours ou les threads de paramètres régionaux durant l'exécution de fonctions sans le suffixe _l. Les fonctions possédant le suffixe _l utiliseront les paramètres régionaux de leurs informations de paramètres régionaux uniquement pendant l'exécution de cette fonction spécifique. Pour créer des paramètres régionaux afin qu'une fonction ayant un suffixe _l puisse les utiliser, 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.

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. Pour plus d'informations, consultez Paramètres régionaux et pages de codes.

Des versions plus sécurisées des fonctions du 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 paramètre de catégorie d'setlocale
atof, _atof_l, _wtof, _wtof_l	Convertissez un caractère en valeur à virgule flottante	LC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_l	Convertissez un caractère en valeur entière	LC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_l	Convertissez un caractère en une valeur entière 64 bits	LC_NUMERIC
atol, _atol_l, _wtol, _wtol_l	Convertissez un caractère en une valeur longue	LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt _atoflt_l	Convertissez un caractère en une valeur double-long	LC_NUMERIC
is routines	Testez un entier donné pour un état particulier.	LC_CTYPE
isleadbyte, _isleadbyte_l	Testez l'octet de tête	LC_CTYPE
localeconv	Lisez les valeurs appropriées pour formatter des quantités numériques	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	Longueur maximale en octets de tout caractère multioctets dans les paramètres régionaux actifs (macro définie dans STDLIB.H)	LC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l	Copiez un caractère multioctets	LC_CTYPE
_mbclen, mblen, _mblen_l	Validez et retournez le nombre d'octets dans un caractère multioctets	LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l	Pour les chaînes de caractères multioctets : validez chaque caractère de la chaîne ; retournez la longueur de chaîne	LC_CTYPE
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l	Convertissez la séquence de caractères multioctets à la séquence correspondante de caractères larges	LC_CTYPE
mbtowc, _mbtowc_l	Convertissez le caractère multioctets au caractère élargi correspondant	LC_CTYPE
Fonctions printf	Ecrivez une sortie mise en forme	LC_NUMERIC (détermine la sortie de caractères de base)
fonctions scanf	Lisez une entrée mise en forme	LC_NUMERIC (détermine la reconnaissance de caractères de base)
setlocale, _wsetlocale	Sélectionnez les paramètres régionaux du programme	Non applicable
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l	Compare les caractères de deux chaînes	LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l	Compare deux chaînes sans tenir compte du cas	LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l	Comparez les caractères de deux chaînes (insensible à la casse)	LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l	Comparez les n premiers caractères de deux chaînes	LC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l	Comparez les caractères de deux chaînes sans tenir compte du cas.	LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l	Comparez les n premiers caractères de deux chaînes (insensible à la casse)	LC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_l	Formattez la valeur de la date et de l'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	Convertissez, en place, chaque lettre majuscule dans la chaîne spécifiée en minuscules	LC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_l	Convertissez 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	Convertissez 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	Convertissez une chaîne de caractères en une valeur longue non signée	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	Convertissez, en place, chaque lettre minuscule de la chaîne spécifiée en majuscules	LC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l	Transformez la chaîne en forme compilée en respectant les paramètres régionaux	LC_COLLATE
tolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l	Convertissez le caractère donné en la minuscule correspondante	LC_CTYPE
toupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l	Convertissez le caractère donné en la lettre majuscule correspondante	LC_CTYPE
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l	Convertissez la séquence de caractères larges à la séquence correspondante de caractères multioctets	LC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_l	Convertissez le caractère élargi au caractère multioctets correspondant	LC_CTYPE

Notes

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 _MB_CP_LOCALE, rend la page de codes multioctets identique à la page de codes setlocale.

Voir aussi

Référence

Internationalisation

Routines runtime par catégorie