Impostazioni localiLocale

Le impostazioni locali si riferiscono alle impostazioni di paese/area geografica e lingua che è possibile usare per personalizzare il programma.Locale refers to country/region and language settings that you can use to customize your program. Alcune categorie dipendenti dalle impostazioni locali includono i formati di visualizzazione per date e valori monetari.Some locale-dependent categories include the display formats for dates and monetary values. Per altre informazioni, vedere Categorie di impostazioni locali.For more information, see Locale Categories.

Usare la funzione setlocale_l per modificare o eseguire una query su alcune o tutte le informazioni riguardanti il programma corrente o le impostazioni locali del thread usando funzioni senza il suffisso .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. Le funzioni con il suffisso _l utilizzeranno il parametro delle impostazioni locali passato per le informazioni sulle impostazioni locali durante l'esecuzione della sola funzione specificata.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. Per creare impostazioni locali da usare con una funzione con suffisso _l, usare _create_locale.To create a locale for use with a function with a _l suffix, use _create_locale. Per rendere disponibili le impostazioni locali, usare _free_locale.To free this locale, use _free_locale. Per ottenere le impostazioni locali correnti, usare _get_current_locale.To get the current locale, use _get_current_locale.

Usare _configthreadlocale per verificare se ogni thread ha le proprie impostazioni locali o se tutti i thread in un programma condividono le stesse impostazioni locali.Use _configthreadlocale to control whether each thread has its own locale, or all threads in a program share the same locale. Per alte informazioni, vedere Impostazioni locali e tabelle codici.For more information, see Locales and Code Pages.

Sono disponibili più versioni sicure delle funzioni presenti nella seguente tabella, indicate dal suffisso _s ("sicuro").More secure versions of the functions in the following table are available, indicated by the _s ("secure") suffix. Per altre informazioni, vedere Security Features in the CRT (Funzionalità di sicurezza in CRT).For more information, see Security Features in the CRT.

Routine dipendenti dalle impostazioni localiLocale-Dependent Routines

RoutineRoutine UsareUse Dipendenza dell'impostazione di categoria setlocalesetlocale category setting dependence
atof, _atof_l, _wtof, _wtof_latof, _atof_l, _wtof, _wtof_l Convertire un carattere in un valore a virgola mobileConvert character to floating-point value LC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_latoi, _atoi_l, _wtoi, _wtoi_l Convertire un carattere in un IntegerConvert character to integer value LC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_l_atoi64, _atoi64_l, _wtoi64, _wtoi64_l Convertire un carattere in un Integer a 64-bitConvert character to 64-bit integer value LC_NUMERIC
atol, _atol_l, _wtol, _wtol_latol, _atol_l, _wtol, _wtol_l Convertire un carattere in un valore longConvert character to long value LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l Convertire un carattere in un valore double-longConvert character to double-long value LC_NUMERIC
is Routinesis Routines Testare l'Integer specificato per condizioni particolari.Test given integer for particular condition. LC_CTYPE
isleadbyte, _isleadbyte_lisleadbyte, _isleadbyte_l Test per il byte inizialeTest for lead byte LC_CTYPE
localeconvlocaleconv Leggere i valori appropriati per la formattazione di quantità numericheRead appropriate values for formatting numeric quantities LC_MONETARY, LC_NUMERIC
MB_CUR_MAXMB_CUR_MAX Lunghezza massima in byte di un carattere multibyte in impostazioni locali correnti (macro definita in STDLIB.H)Maximum length in bytes of any multibyte character in current locale (macro defined in STDLIB.H) LC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l Copiare un carattere multibyteCopy one multibyte character LC_CTYPE
_mbclen, mblen, _mblen_l_mbclen, mblen, _mblen_l Convalidare e restituire il numero di byte in carattere multibyteValidate and return number of bytes in multibyte character LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_lstrlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l Per le stringhe di caratteri multibyte: convalidare ciascun carattere della stringa; restituire la lunghezza della stringaFor multibyte-character strings: validate each character in string; return string length LC_CTYPE
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_lmbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l Converte una sequenza di caratteri multibyte in una sequenza di caratteri wide corrispondenteConvert sequence of multibyte characters to corresponding sequence of wide characters LC_CTYPE
mbtowc, _mbtowc_lmbtowc, _mbtowc_l Converte un carattere multibyte in un carattere wide corrispondenteConvert multibyte character to corresponding wide character LC_CTYPE
Funzioni printfprintf functions Scrivere l'output formattatoWrite formatted output LC_NUMERIC (determina l'output di caratteri radice)LC_NUMERIC (determines radix character output)
Funzioni scanfscanf functions Leggere l'input formattatoRead formatted input LC_NUMERIC (determina il riconoscimento di caratteri radice)LC_NUMERIC (determines radix character recognition)
setlocale, _wsetlocalesetlocale, _wsetlocale Selezionare le impostazioni locali per il programmaSelect locale for program Non applicabileNot applicable
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_lstrcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l Confronta i caratteri di due stringheCompare characters of two strings LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l Confronta due stringhe senza fare distinzione tra maiuscole e minuscoleCompare two strings without regard to case LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l Confrontare i caratteri di due stringhe (senza distinzione tra maiuscole e minuscole)Compare characters of two strings (case insensitive) LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l Confrontare i primi caratteri n di due stringheCompare first n characters of two strings LC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l Confrontare i caratteri di due stringhe senza fare distinzione tra maiuscole e minuscole.Compare characters of two strings without regard to case. LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l Confrontare i primi caratteri n di due stringhe (senza distinzione tra maiuscole e minuscole)Compare first n characters of two strings (case insensitive) LC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_lstrftime, wcsftime, _strftime_l, _wcsftime_l Formattare il valore di data e ora secondo l'argomento format fornitoFormat date and time value according to supplied format argument 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_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l Convertire, sul posto, ogni lettera maiuscola della stringa specificata in lettera minuscolaConvert, in place, each uppercase letter in given string to lowercase LC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_lstrtod, _strtod_l, wcstod, _wcstod_l Convertire una stringa di caratteri in un valore doubleConvert character string to double value LC_NUMERIC (determina il riconoscimento di caratteri radice)LC_NUMERIC (determines radix character recognition)
strtol, wcstol, _strtol_l, _wcstol_lstrtol, wcstol, _strtol_l, _wcstol_l Convertire una stringa di caratteri in un valore longConvert character string to long value LC_NUMERIC (determina il riconoscimento di caratteri radice)LC_NUMERIC (determines radix character recognition)
strtoul, _strtoul_l, wcstoul, _wcstoul_lstrtoul, _strtoul_l, wcstoul, _wcstoul_l Convertire una stringa di caratteri in un valore long unsignedConvert character string to unsigned long value LC_NUMERIC (determina il riconoscimento di caratteri radice)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 Convertire, sul posto, ogni lettera minuscola della stringa in una lettera maiuscolaConvert, in place, each lowercase letter in string to uppercase LC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_lstrxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l Trasformare la stringa in un formato fascicolato in base alle impostazioni localiTransform string into collated form according to locale LC_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 Convertire il carattere dato nel carattere minuscolo corrispondenteConvert given character to corresponding lowercase character LC_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 Convertire il carattere dato nel carattere maiuscolo corrispondenteConvert given character to corresponding uppercase letter LC_CTYPE
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_lwcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l Converte una sequenza di caratteri wide in una sequenza di caratteri multibyte corrispondenteConvert sequence of wide characters to corresponding sequence of multibyte characters LC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_lwctomb, _wctomb_l,wctomb_s, _wctomb_s_l Converte un carattere wide in un carattere multibyte corrispondenteConvert wide character to corresponding multibyte character LC_CTYPE

Nota

Per le routine multibyte, la tabella codici multibyte deve essere equivalente alle impostazioni locali impostate con setlocale.For multibyte routines, the multibyte code page must be equivalent to the locale set with setlocale. _setmbcp, con un argomento di _MB_CP_LOCALE, rende la tabella codici multibyte la stessa della tabella codici setlocale._setmbcp, with an argument of _MB_CP_LOCALE makes the multibyte code page the same as the setlocale code page.

Vedere ancheSee Also

Internazionalizzazione Internationalization
Routine di runtime per categoriaRun-Time Routines by Category