catgets(3c)

名前

catgets()-プログラム・メッセージの読み取り

形式

#include <nl_types.h> 
char *catgets (nl_catd catd, int set_num, int msg_num, char *s)

機能説明

catgets() は、セット set_num 内のメッセージ msg_num を、catd で指定されたメッセージ・カタログから読み取ります。catd は、先に呼び出された catopen() から返されたカタログ記述子です。s は、デフォルトのメッセージ文字列を指すポインタであり、指定されたメッセージ・カタログが現在利用できない場合に、catgets() から返されます。

マルチスレッドのアプリケーションのスレッドは、TPINVALIDCONTEXT を含むどんなコンテキスト状態でも、catgets() を呼び出すことができます。

診断

指定されたメッセージが正常に取り出されると、catgets() は NULL で終了するメッセージ文字列を収める内部バッファ領域を指すポインタを返します。catd によって指定されているメッセージ・カタログがその時点で利用できないために呼び出しが異常終了した場合には、s を指すポインタが返されます。

関連項目