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