Man page - catgets(3)

Packages contains this manual

Available languages:

en fr pt_BR es pl ja ru ro de

Manual

CATGETS

名 前
書 式
説 明
返 り 値
属 性
準 拠
注 意
関 連 項 目
こ の 文 書 に つ い て

名 前

catgets - メ ッ セ ー ジ カ タ ロ グ か ら メ ッ セ ー ジ を 取 り 出 す

書 式

#include <nl_types.h>

char *catgets(nl_catd catalog , int set_number , int message_number ,
const char * message );

説 明

catgets () は catalog で 指 定 さ れ た メ ッ セ ー ジ カ タ ロ グ か ら 、 セ ッ ト set_number の メ ッ セ ー ジ message_number を 読 み 取 る 。 catalog は 、 catopen (3) の 呼 び 出 し に よ っ て 得 ら れ た カ タ ロ グ デ ィ ス ク リ プ タ ー を 指 定 す る 。 4番 目 の 引 数 message は 、 指 定 の メ ッ セ ー ジ カ タ ロ グ が 現 在 利 用 で き な い 場 合 に catgets () が 返 す デ フ ォ ル ト の メ ッ セ ー ジ を 指 す 。 メ ッ セ ー ジ テ キ ス ト は 内 部 の バ ッ フ ァ ー 領 域 に 格 納 さ れ て お り 、 保 存 や 変 更 を 行 う 場 合 に は ア プ リ ケ ー シ ョ ン 側 で コ ピ ー す る 必 要 が あ る 。 返 さ れ る 文 字 列 は 常 に ヌ ル バ イ ト ('\0') で 終 端 さ れ る 。

返 り 値

成 功 し た 場 合 、 catgets () は 内 部 の バ ッ フ ァ ー 領 域 へ の ポ イ ン タ ー を 返 す 。 こ こ に は ヌ ル 文 字 で 終 端 さ れ た メ ッ セ ー ジ 文 字 列 が 格 納 さ れ て い る 。 失 敗 し た 場 合 は message を 返 す 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-32444-1.png

準 拠

POSIX.1-2001, POSIX.1-2008.

注 意

catgets () 関 数 は libc.so.4.4.4c 以 降 で し か 使 え な い 。 Jan 1987 X/Open Portability Guide で は 、 エ ラ ー の 時 に 返 さ れ る 値 に よ り 微 妙 な 指 定 を し て い る 。 catalog で 指 定 さ れ た メ ッ セ ー ジ カ タ ロ グ が 利 用 で き な い 場 合 は message を 返 し 、 一 方 メ ッ セ ー ジ カ タ ロ グ は あ る が 指 定 し た メ ッ セ ー ジ が な い 場 合 は 空 の 文 字 列 が 返 さ れ る 。 SUSv2 で は こ の 二 種 類 の エ ラ ー リ タ ー ン は 廃 止 さ れ 、 常 に message を 返 す こ と に し た よ う で あ る 。

関 連 項 目

catopen (3), setlocale (3)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。