名称

catgets — メッセージカタログから文字列を検索して取り出す

ライブラリ

Standard C Library (libc, -lc)

書式

#include < nl_types.h>

char *
catgets( nl_catd catd, int set_id, int msg_id, const char *s);

解説

catgets() 関数は、記述子 catd によって参照されるメッセージカタログのセット set_id のメッセージ msg_id を検索することを試みます。引数 s は、関数が指定されたメッセージを検索することができない場合に返されるデフォルトメッセージを指します。

戻り値

指定されたメッセージの検索が成功するなら、 catgets() は、メッセージ文字列を含んでいる内部のバッファへのポインタを返します。そうでなければ、 s を返します。

エラー

[ EBADF]

catd 引数が有効なメッセージカタログ記述子ではありません。

[ EBADMSG]

set_id と msg_id によって識別されるメッセージがメッセージカタログにありません。

関連項目

gencat(1), catclose(3), catopen(3)

規格

catgets() 関数は、 IEEE Std 1003.1-2001 (“POSIX.1”) に適合しています。