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() 返回正確的結果. 現在不講英語的歐洲人會比以前更麻煩一些, 他們需要安裝相應的區域選項檔案.