.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   GNU gettext source code and manual
.\"   LI18NUX 2000 Globalization Specification
.\"

.TH BINDTEXTDOMAIN 3 "May 2001" "GNU gettext 0.10.38"
.SH NAME
bindtextdomain \- 設置 包括 消息條目 的 路徑

.SH "總覽 (SYNOPSIS)"
.nf
.B #include <libintl.h>
.sp
.BI "char * bindtextdomain (const char * " domainname ", const char * " dirname );
.fi

.SH "描述 (DESCRIPTION)"
\fBbindtextdomain\fP 函數 的 作用 是 設置 指定消息域 裏，包含 消息條目
(message catalog) 的 基本目錄 層次結構。

.PP
一個 消息域 是 一套 可翻譯的 \fImsgid\fP 消息。 通常，
每一個 軟件包 有 它自己的 消息域。 提出 \fBbindtextdomain\fP 的 需求 是因爲
軟件包 安裝 的 時候，並不總和 <libintl.h> 頭文件 和 libc/libintl 庫文件 的前綴
保持一致.

.PP
消息條目 期望的 路徑名 是
\fIdirname\fP/\fIlocale\fP/\fIcategory\fP/\fIdomainname\fP.mo,
其中 \fIlocale\fP 是 locale 名, 而 \fIcategory\fP 是 locale 面, 如 
\fBLC_MESSAGES\fP.
.PP
\fIdomainname\fP 必須 是 非空字符串。
.PP
如果 \fIdirname\fP 不是 NULL, 屬於 \fIdomainname\fP 域 的
消息條目 的 基本目錄 被設置爲 \fIdirname\fP。 函數 能夠 複製 參數字符串。
如果 程序 希望 調用 \fBchdir\fP 函數， \fIdirname\fP 必須 是 絕對路徑名；
否則 程序 無法 保證 找到 消息條目。
.PP
如果 \fIdirname\fP 是 NULL， 函數 返回 以前 爲 \fIdomainname\fP 域 設置的 
基本目錄。

.SH "返回值 (RETURN VALUE)"
如果成功, \fBbindtextdomain\fP 函數 返回 當前 \fIdomainname\fP 域
的 基本目錄, 如果 改變了 基本目錄, 返回 改變後的 基本目錄。 
返回的 字符串 一直 有效, 直到 下一次 對 同一個 \fIdomainname\fP 調用
\fBbindtextdomain\fP; 這個 字符串 不應該 被修改 或 釋放。
如果 發生 內存分配錯誤, \fBerrno\fP 設置爲 \fBENOMEM\fP, 然後 返回 NULL.

.SH "錯誤 (ERRORS)"
下列 錯誤 可能 發生， 包括 其它的：
.TP
.B ENOMEM
沒有 足夠的 內存 可用。

.SH BUGS
返回類型 應該是 \fBconst char *\fP, 但是 爲了 避免 較早版本 ANSI C 代碼 的 
警告, 返回類型 是 \fBchar *\fP.

.SH "另見 (SEE ALSO)"
.BR gettext (3),
.BR dgettext (3),
.BR dcgettext (3),
.BR ngettext (3),
.BR dngettext (3),
.BR dcngettext (3),
.BR textdomain (3),
.BR realpath (3)

.SH "[中文版維護人]"
.B Viamu <viamu@msn.com>
.SH "[中文版最新更新]"
2003/11/28
.SH "[中文版校對人]"
.B Xuming <xuming@users.sourceforge.net>
.SH "《中文MAN-PAGE計劃》"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR