地區設定

地區設定 是指您可使用自訂程式的國家/地區及語言設定。 有些與地區設定相關的類別含有日期格式和貨幣值的顯示格式。 如需詳細資訊，請參閱地區設定分類。

當使用沒有 _l 後置字元的函式時，請使用 setlocale 函式變更或查詢的部分或所有目前的程式或執行緒的地區設定資訊。 只在特定函式執行的期間，與 _l 尾碼的函式會使用地區設定參數傳入資訊。 若要建立一個地區設定為具有函式搭配 _l 後置字元，請使用 _create_locale。 若要釋放這個地區設定，請使用 _free_locale。 若要取得目前的地區設定，請使用 _get_current_locale。

使用 _configthreadlocale 控制是否每個執行緒有自己的地區設定或是所有在相同程式中的執行緒共享同樣的地區設定。 如需詳細資訊和範例程式碼，請參閱 地區設定和程式碼頁面。

下表有更多可用的函式安全版，由 _s (安全版)) 尾碼表示。 如需詳細資訊，請參閱CRT 中的安全性功能。

地區設定相依的常式

常式	使用	setlocale 類別設定相關屬性
atof、_atof_l、_wtof、_wtof_l	轉換字元至浮點數	LC_NUMERIC
atoi、_atoi_l、_wtoi、_wtoi_l	轉換字元至整數	LC_NUMERIC
_atoi64、_atoi64_l、_wtoi64、_wtoi64_l	轉換字元至64位元整數	LC_NUMERIC
atol、_atol_l、_wtol、_wtol_l	轉換字元至 long 型別的值	LC_NUMERIC
_atodbl、_atodbl_l、_atoldbl、_atoldbl_l、_atoflt _atoflt_l	轉換字元至 double-long 型別的值	LC_NUMERIC
is 常式	在特定情況下給予整數的測試。	LC_CTYPE
isleadbyte、_isleadbyte_l	前導位元組的測試	LC_CTYPE
localeconv	讀取格式化的數字數量的適當值。	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	最大長度 (以位元組任何多位元組字元在目前地區設定 (在 STDLIB.H) )定義的巨集	LC_CTYPE
_mbccpy、_mbccpy_l,_mbccpy_s、_mbccpy_s_l	複製一個多位元組字元	LC_CTYPE
_mbclen、mblen、_mblen_l	驗證並傳回以多位元表示的位元組數目	LC_CTYPE
strlen、wcslen、_mbslen、_mbslen_l、_mbstrlen、_mbstrlen_l	對於多位元組字元字串:驗證字串中的每個字元;傳回字串的長度。	LC_CTYPE
mbstowcs、_mbstowcs_l,mbstowcs_s、_mbstowcs_s_l	轉換多位元組字元序列至對應的寬字元序列	LC_CTYPE
mbtowc、_mbtowc_l	轉換多位元組字元至對應的寬字元	LC_CTYPE
printf 函式	寫入格式化輸出	LC_NUMERIC (判斷基底字元輸出)
scanf 函式	讀取格式輸入	LC_NUMERIC (判斷基底字元辨識)
setlocale、_wsetlocale	為應用程式設定(地區設定)	不適用
strcoll、wcscoll、_mbscoll、_strcoll_l、_wcscoll_l、_mbscoll_l	比較兩個字串的字元	LC_COLLATE
_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l	不考慮大小寫的比較兩個字串	LC_CTYPE
_stricoll、_wcsicoll、_mbsicoll、_stricoll_l、_wcsicoll_l、_mbsicoll_l	比較兩個字串的字元 (不區分大小寫)	LC_COLLATE
_strncoll、_wcsncoll、_mbsncoll、_strncoll_l、_wcsncoll_l、_mbsncoll_l	比較兩個字串第 n 個字元	LC_COLLATE
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l	不考慮大小寫的比較兩個字串的字元。	LC_CTYPE
_strnicoll、_wcsnicoll、_mbsnicoll、_strnicoll_l、_wcsnicoll_l、_mbsnicoll_l	比較兩個字串第 n個字元 (不區分大小寫)	LC_COLLATE
strftime、wcsftime、_strftime_l、_wcsftime_l	根據提供的 format 引數格式化日期和時間值	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	在正確的地方，轉換每個大寫字母至小寫字母	LC_CTYPE
strtod、_strtod_l、wcstod、_wcstod_l	轉換字元字串至 double 值。	LC_NUMERIC (判斷基底字元辨識)
strtol、wcstol、_strtol_l、_wcstol_l	轉換字元字串至 long 值	LC_NUMERIC (判斷基底字元辨識)
strtoul、_strtoul_l、wcstoul、_wcstoul_l	將字串轉換成不帶正負號的長整數值	LC_NUMERIC (判斷基底字元辨識)
_strupr、_strupr_l、_mbsupr、_mbsupr_l、_wcsupr_l、_wcsupr,_strupr_s、_strupr_s_l、_mbsupr_s、_mbsupr_s_l、_wcsupr_s、_wcsupr_s_l	在正確的地方，轉換每個小寫字母至大寫字母	LC_CTYPE
strxfrm、wcsxfrm、_strxfrm_l、_wcsxfrm_l	轉換成字串自動分頁的表單根據地區設定	LC_COLLATE
tolower、_tolower、towlower、_tolower_l、_towlower_l,_mbctolower、_mbctolower_l、_mbctoupper、_mbctoupper_l	轉換指定字元對應的小寫字母	LC_CTYPE
toupper、_toupper、towupper、_toupper_l、_towupper_l,_mbctolower、_mbctolower_l、_mbctoupper、_mbctoupper_l	轉換指定字元對應的大寫字母。	LC_CTYPE
wcstombs、_wcstombs_l,wcstombs_s、_wcstombs_s_l	轉換寬字元序列至對應的多位元組字元序列	LC_CTYPE
wctomb、_wctomb_l,wctomb_s、_wctomb_s_l	轉換寬字元至對應的多位元組字元	LC_CTYPE

注意事項
對於多位元組常式，多位元組字碼頁必須和有setlocale的地區設定相等 。有 _MB_CP_LOCALE 引數的_setmbcp使多位元字碼頁和 setlocale 字碼頁相同。

請參閱

參考

國際化

依分類區分的執行階段常式