BINDTEXTDOMAIN(3) Library Functions Manual BINDTEXTDOMAIN(3)

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)

下列 錯誤 可能 發生, 包括 其它的:

沒有 足夠的 記憶體 可用。

返回型別 應該是 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

May 2001 GNU gettext 0.10.38