NAME¶
bindtextdomain - 設置 包括
消息條目 的 路徑
總覽 (SYNOPSIS)¶
#include <libintl.h>
char * bindtextdomain (const char * domainname, const char * dirname);
描述 (DESCRIPTION)¶
bindtextdomain 函數 的 作用 是
設置 指定消息域
裏,包含 消息條目 (message
catalog) 的 基本目錄
層次結構。
一個 消息域 是 一套
可翻譯的
msgid 消息。
通常, 每一個 套件 有
它自己的 消息域。
提出
bindtextdomain 的 需求
是因為 套件 安裝 的
時候,並不總和 <libintl.h>
頭檔案 和 libc/libintl 庫檔案
的前綴 保持一致.
消息條目 期望的
路徑名 是
dirname/
locale/
category/
domainname.mo,
其中
locale 是 locale 名, 而
category 是 locale 面, 如
LC_MESSAGES.
domainname 必須 是
非空字符串。
如果
dirname 不是 NULL, 屬於
domainname 域 的 消息條目 的
基本目錄 被設置為
dirname。 函數 能夠 複製
參數字符串。 如果
程式 希望 調用
chdir
函數,
dirname 必須 是
絕對路徑名; 否則
程式 無法 保証 找到
消息條目。
如果
dirname 是 NULL, 函數
返回 以前 為
domainname 域
設置的 基本目錄。
返回值 (RETURN VALUE)¶
如果成功,
bindtextdomain 函數
返回 當前
domainname 域 的
基本目錄, 如果 改變了
基本目錄, 返回
改變後的 基本目錄。
返回的 字符串 一直
有效, 直到 下一次 對
同一個
domainname 調用
bindtextdomain; 這個 字符串
不應該 被修改 或
釋放。 如果 發生
記憶體分配錯誤,
errno
設置為
ENOMEM, 然後 返回
NULL.
錯誤 (ERRORS)¶
下列 錯誤 可能 發生,
包括 其它的:
- ENOMEM
- 沒有 足夠的 記憶體
可用。
BUGS¶
返回類型 應該是
const char *,
但是 為了 避免
較早版本 ANSI C 代碼 的
警告, 返回類型 是
char *.
另見 (SEE ALSO)¶
gettext(3),
dgettext(3),
dcgettext(3),
ngettext(3),
dngettext(3),
dcngettext(3),
textdomain(3),
realpath(3)
[中文版維護人]¶
Viamu <viamu@msn.com>
[中文版最新更新]¶
2003/11/28
[中文版校對人]¶
Xuming <xuming@users.sourceforge.net>
《中文MAN-PAGE計劃》¶
http://cmpp.linuxforum.net