CATGETS(3)

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

書式

#include <features.h>
#include <nl_types.h>

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

説明

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

返り値

成功した場合、 catgets() は内部のバッファ領域に格納されているヌル文字で 終端されたメッセージ文字列へのポインタを返す。 catalog で指定されたメッセージカタログが現在利用できないために失敗した 場合は message を返す。 一方、メッセージカタログが利用可能であるが、指定メッセージを含んでいない 場合には、空文字列を返す。

注意
これらの関数は、libc.so.4.4.4c 以降でのみ利用可能である。 二通りのエラーリターンが起こる可能性は、常に message を返すために XPG4.2 で削除されたようである。

関連項目
catopen(3), setlocale(3)