Man page - bindtextdomain(3)
Packages contains this manual
Available languages:
en zh_TW zh_CNManual
BINDTEXTDOMAIN
NAME總 覽 (SYNOPSIS)
描 述 (DESCRIPTION)
返 回 值 (RETURN VALUE)
錯 誤 (ERRORS)
BUGS
另 見 (SEE ALSO)
[中 文 版 維 護 人 ]
[中 文 版 最 新 更 新 ]
[中 文 版 校 對 人 ]
《 中 文 MAN-PAGE計 劃 》
跋
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
跋
本
頁 面 中 文 版 由
中 文 man 手 冊 頁 計
劃 提 供 。
中 文 man 手 冊 頁 計
劃 :
https://github.com/man-pages-zh/manpages-zh