Provided by: manpages-zh_1.5.2-1_all bug

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