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 [AT] msn.com>
[中 文 版 最 新 更 新 ]
2003/11/28
[中 文 版 校 對 人 ]
Xuming <xuming [AT] users.net>
《 中 文 MAN-PAGE計 劃 》
跋
本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh