Man page - bindtextdomain(3)

Packages contains this manual

Available languages:

en zh_TW zh_CN

Manual

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