名称

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単一の文字列として、リソース値のペアを指定します。 シングル・コロン (:) は、名前と、値を区切ります。

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

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

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

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

解説

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

データベースが NULL を含む場合は、 XrmQPutResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 データベースが NULL を含む場合は、 XrmPutStringResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmPutStringResource は、指定された値をもつリソースを、指定されたデータベースへ追加します。 XrmPutStringResource は、リソースと値の両方をナルで終わる文字列として取り、 それらをクォークへ変換し、それから “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” をもちます。 改行なしのナルで終わる文字列も利用可能です。

関連事項

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

NEWS-OSRelease 3.3