NAME

setlocale - 設置當前的區域選項

總覽 (SYNOPSIS)

#include <locale.h>

char *setlocale(int category, const char * locale);

描述 (DESCRIPTION)

setlocale() 函數用來設置或者查詢程序當前的區域選項.

如果 locale 不是 NULL, 程序就會根據參數更改相應的區域選項. category 參數指定區域選項的哪一部分需要更改.

LC_ALL: 代表所有部分.
LC_COLLATE: 代表正則表達式匹配 (和範圍表達式[range expressions] 以及字符類[classes] 有關係) 和字符串排序.
LC_CTYPE: 代表正則表達式匹配, 字符類(character classification), 轉換, 區分大小寫的比較, 以及寬字符函數.
LC_MESSAGES: 代表可以本地化的消息 (自然語言).
LC_MONETARY: 代表貨幣格式.
LC_NUMERIC: 代表數字格式 (比如小數點和千位分組符).
LC_TIME: 代表時間和日期格式.

locale 參數是一個指向字符串的指針. 此字符串爲 category 需要的設置. 此字符串可以是一個衆所周知的區域選項常量, 如 "C" 或 "da_DK" (見下), 也可以是另外一個 setlocale 調用返回的字符串.

如果 locale 是 "", 需要更改的部分會根據環境變量做相應的設置. 具體的和實現有關. 對於 glibc 來說, 首先查看環境變量 LC_ALL (不管 category),然後查看和category (LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC, LC_TIME) 同名的環境變量, 最後查看環境變量 LANG. 以先查到的環境變量爲準. 如果其值不是一個有效的區域選項, 區域選項將不會改變, setlocale 會返回 NULL.

標準區域選項 "C" 和 "POSIX" 是可移植的; 它的 LC_CTYPE 部分對應的是 7 位的 ASCII 字符集.

一個典型的區域選項有如下的格式: language[_territory][.codeset][@modifier], 其中 language 是一個 ISO 639 語言代碼, territory 是一個 ISO 3166 國家代碼, codeset 是一個象 ISO-8859-1 或者 UTF-8 的字符集或者編碼標識符. 用 "locale -a", cf. locale(1) 可以獲得一個系統支持的區域選項的列表.

如果 locale 是 NULL, 意味着只是查詢當前的區域選項而不更改它.

當 main 程序開始的時候可移植的 "C" 區域選項作爲默認值被設置. 一個程序可以在初始化之後調用 setlocale(LC_ALL, "" ) 函數, 並且從 localeconv() 調用的返回中獲得和區域選項相關的信息, 如果 MB_CUR_MAX > 1 就用多字節和寬字節函數來處理文本, 用 strcoll(), wcscoll() 或者 strxfrm(), wcsxfrm() 來比較字符串, 這樣就可以使程序有較好的移植性.

返回值 (RETURN VALUE)

一個成功的 setlocale() 調用會返回一個表示當前區域選項的字符串 (指針). 這個字符串可能是在靜態存儲區中分配的. 之後用相應的 category 和這個字符串作爲參數再去調用這個函數會重新把程序區域選項的相應部分恢復. 如果請求不能完成將會返回 NULL .

遵循 (CONFORMING TO)

ANSI C, POSIX.1

注意 (NOTES)

Linux (也就是, GNU libc) 支持可移植的 "C" 和 "POSIX" 區域選項. 在以前它曾經支持歐洲 Latin-1 區域選項 "ISO-8859-1" (比如說在 libc-4.5.21 和 libc-4.6.27 中), 和俄羅斯的 "KOI-8" (更準確點是, "koi-8r") 區域選項 (比如在 libc-4.6.27 中), 所以設置一個環境變量 LC_CTYPE=ISO-8859-1 就能夠讓 isprint() 返回正確的結果. 現在不講英語的歐洲人會比以前更麻煩一些, 他們需要安裝相應的區域選項文件.