名称

XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPutStringResource, XrmPutLineResource - データベースリソースをストアする

形式

void XrmPutResource(database, specifier, type, value)
     XrmDatabase ∗database;
     char ∗specifier;
     char ∗type;
     XrmValue ∗value; void XrmQPutResource(database, bindings, quarks, type, value)
     XrmDatabase ∗database;
     XrmBindingList bindings;
     XrmQuarkList quarks;
     XrmRepresentation type;
     XrmValue ∗value; void XrmPutStringResource(database, specifier, value)
     XrmDatabase ∗database;
     char ∗specifier;
     char ∗value; void XrmQPutStringResource(database, bindings, quarks, value)
     XrmDatabase ∗database;
     XrmBindingList bindings;
     XrmQuarkList quarks;
     char ∗value; void XrmPutLineResource(database, line)
     XrmDatabase ∗database;
     char ∗line;

引数

bindingsバインディングリストを指定します。

databaseリソースデータベースを指定します。

line単一の文字列として、 リソースの名前と値をペア ( ResourceLine フォーマット ) で指定します ( 10.11 参照 )。 シングル・コロン (:) は、名前と、値を区切ります。 ただし、コメント行は、記述できません。

quarksリソースの完全な、又は部分的な名前、またはクラスリストを指定します。

specifierリソースの完全な、または部分的な仕様を指定します。

typeリソースの型を指定します。

valueリソースの値を指定します。それは文字列として指定されます。

解説

データベースが NULL を含む場合、 XrmPutResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmPutResource は、それにひき続いて XrmStringToBindingQuarkList を XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value) として呼び出すのに便利な関数です。

データベースが NULL を含む場合は、 XrmQPutResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 データベースが NULL を含む場合は、 XrmPutStringResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmPutStringResource は、指定された値をもつリソースを、指定されたデータベースへ追加します。 XrmPutStringResource は、初めに XrmStringToBindingQuarkList で文字列を分離してから、 “String” 表示タイプを用いて XrmQPutResource でデータベースを作成する便利なルーチンです。 データベースが NULL を含む場合は、 XrmQPutStringResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmQPutStringResource は、 XrmValue に文字長を代入し ( サイズを計算するために strlen を呼び出すことによる ) 、それから “String” 表示タイプを用いて XrmQPutResource を呼び出す便利なルーチンです。 データベースが NULL を含む場合は、 XrmPutLineResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmPutLineResource は、一つのリソースエントリを指定されたデータベースへ追加します。 名前の前後のスペースキャラクター ( 空白文字 ) または line 引数中の コロンはどれも無視されます。 値は、 new-line または NULL 文字により終了します。 値が組み込みの new-line 文字を含むことができるようにするために、 “\n” が認識され、 new-line 文字と置き換えられます。 例えば、 line 引数は、値 “xterm∗background:green\n” をもちます。 改行なしのナルで終わる文字列も利用可能です。 任意の 4 文字の 8 進数の文字列 \nnn ( n は、"0"−"7" の値 ) は、 1 バイトに変換されます。しかし、内部では 8 進数の文字列と解釈されます。 例えば、NULL の値は、\000 の文字列で記述することができます。

関連事項

XrmGetResource(3X11), XrmInitialize(3X11), XrmMergeDatabases(3X11), XrmUniqueQuark(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.1C