名称

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)

として呼び出すのに便利な関数です。 指定子および型が、 ホストデータベース文字コード (Host Portable Character Encoding) でない場合は、 結果は、インプリメンテーションにより異なります。 値は、修正されずに、データベースに格納されます。 データベースが NULL を含む場合は、 XrmQPutResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 同一のバインディングおよびクォークを持つリソースのエントリが データベースに存在する場合は、 元の値は、新たに指定された値と置き換えられます。 値は、修正されずに、データベースに格納されます。 データベースが NULL を含む場合は、 XrmPutStringResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmPutStringResource は、指定された値をもつリソースを、指定されたデータベースへ追加します。 XrmPutStringResource は、初めに XrmStringToBindingQuarkList で文字列を分離してから、 “String” 表示タイプを用いて XrmQPutResource でデータベースを作成する便利なルーチンです。 指定子がホストポータブル文字コード (Host Portable Character Encoding) にない場合は、 結果はインプリメンテーションにより異なります。 値は、修正されずに、データベースに格納されます。 データベースが NULL を含む場合は、 XrmQPutStringResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmQPutStringResource は、 XrmValue に文字長を代入し (サイズを計算するために strlen を呼び出すことによる)、それから “String” 表示タイプを用いて XrmQPutResource を呼び出す便利なルーチンです。 値は、修正されずに、データベースに格納されます。 データベースが NULL を含む場合は、 XrmPutLineResource は、新しいデータベースを作成し、新しいデータベースを指すポインタを 返します。 XrmPutLineResource は、一つのリソースエントリを指定されたデータベースへ追加します。 行は、有効な ResourceLine フォーマットで なければいけません (15.1 節参照)。 文字列は、データベースの locale でパースされます。 ResourceName がホストポータブル文字コード (Host Portable Character Encoding) で ない場合は、結果は、インプリメンテーションにより異なります。 コメント行は格納されませんのでご注意ください。

関連事項

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

NEWS-OSRelease 4.2.1R