名前

catopen()、catclose()−メッセージ・カタログのオープン/クローズ

形式

#include <nl_types.h> 
nl_catd catopen (char *name, int oflag) 
int catclose (nl_catd catd)

機能説明

メッセージ・カタログの名前とそれらの格納場所は、システムによって異なる可能性があります。個々のアプリケーションは、それぞれのニーズに従ってメッセージ・カタログの名前を付けたり、格納場所を指定したりすることができます。したがって、カタログを格納する場所を指定するためのメカニズムが必要となります。

NLSPATH 変数では、メッセージ・カタログの格納場所を検索パスの形式で指定したり、メッセージ・カタログ・ファイルに対応するネーミング規則を使用することができます。次に例を示します。

NLSPATH=/nlslib/%L/%N.cat:/nlslib/%N/%L

メタキャラクタ % は、置換フィールドを示します。この例で、%L は LANG 環境変数の現在の設定と置き替わります (下記の項を参照)。また、%N は catopen() に渡される name パラメータの値と置き替わります。このため、上例で、catopen() はまず /nlslib/$LANG/name.cat、次に /nlslib/name/$LANG を検索して、目的のメッセージ・カタログを見つけようとします。

NLSPATH は通常、システム全体にわたって有効になるよう設定されるので (すなわち、/etc/profile)、メッセージ・カタログに関連する格納場所とネーミング規則をプログラムもユーザも意識する必要はありません。

次の表は、メタキャラクタ・セットのリストです。

LANG 環境変数では、ネイティブ言語、地域の習慣および文字セットに関してユーザの要求条件を ASCII 文字列の形式 (LANG=language[_territory[.codeset]]) で指定することができます。

オーストリアで使用されるドイツ語を話すユーザが、ISO 8859/1 コードセットを用いている端末を使用する場合、LANG 環境変数は次のように設定します。

LANG=De_A.88591

この設定により、ユーザは関連するカタログ (存在すれば) を見つけることができるはずです。

引数 oflag() は使用されません。この引数は将来使用する予定であり、現在は必ずゼロを指定してください。このフィールドの値を別の値に変更した場合の動作は不定です。

catclose() は catd によって指定されたメッセージ・カタログをクローズします。

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

診断

正常終了の場合、catopen() は、以後の catgets() および catclose() の呼び出し時に使用するメッセージ・カタログ記述子を返します。異常終了であれば、catopen() は (nl_catd) -1 を返します。catclose() は、正常終了のとき 0、異常終了のとき -1 を返します。

関連項目