CATOPEN

Section: C Library Functions (3)
索引 jman

BSD mandoc

索引

名称

catopen - メッセージカタログのオープン

索引

ライブラリ

Lb libc

索引

書式

In nl_types.h Ft nl_catd Fn catopen const char *name int oflag

索引

解説

Fn catopen 関数は、 Fa name によって指定されたメッセージカタログをオープンし、メッセージカタログの記述子を返します。 Fa name に 1 つの `/ ' が含まれている場合には、 Fa name はメッセージカタログのフルパス名を指定します。そうでない場合には、環境変数の値 NLSPATH が以下の置換とともに使用されます。

%N: Fa name 引数の値です。
%L: LANG 環境変数または LC_MESSAGES カテゴリ (下記参照) の値です。
%l: LANG 環境変数または LC_MESSAGES カテゴリの言語要素です。
%t: LANG 環境変数または LC_MESSAGES カテゴリの地域要素です。
%c: LANG 環境変数または LC_MESSAGES カテゴリのコードセット要素です。
%%: 単一の % 文字です。

空の文字列は未定義の値に置換されます。

NLSPATH で定義されるパス名のテンプレートは、コロン ( `:' で区切られます。先頭のまたは 2 つの隣接するコロンは、%N を指定したのと同等です。

Fa oflag 引数が NL_CAT_LOCALE 定数に設定されている場合には、 LC_MESSAGES ロケールカテゴリがメッセージカタログをオープンするために使用されます。 NL_CAT_LOCALE の使用は、 St -xpg4 規格に適合しています。 St -xpg3 との互換性のために 0 を指定することができます。 Fa oflag が 0 に設定されている時には、 LANG 環境変数がメッセージカタログのロケールを決定します。

メッセージカタログの記述子は、プロセスがそれをクローズするまで、または 1 つの exec(3) 関数の呼び出しの成功まで、有効に残ります。

索引