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