名称

XrmUniqueQuark, XrmStringToQuark, XrmPermStringToQuark, XrmQuarkToString, XrmStringToQuarkList, XrmStringToBindingQuarkList - リソースクォークを操作する

形式

XrmQuark XrmUniqueQuark() #define XrmStringToName(string) XrmStringToQuark(string) #define XrmStringToClass(string) XrmStringToQuark(string) #define XrmStringToRepresentation(string) XrmStringToQuark(string) XrmQuark XrmStringToQuark(string)
     char ∗string; XrmQuark XrmPermStringToQuark(string)
     char ∗string; #define XrmStringToName(string) XrmStringToQuark(string) #define XrmStringToClass(string) XrmStringToQuark(string) #define XrmStringToRepresentation(string) XrmStringToQuark(string) XrmQuark XrmStringToQuark(string)
     char ∗string; XrmQuark XrmPermStringToQuark(string)
     char ∗string; #define XrmNameToString(name) XrmQuarkToString(name) #define XrmClassToString(class) XrmQuarkToString(class) #define XrmRepresentationToString(type) XrmQuarkToString(type) char ∗XrmQuarkToString(quark)
     XrmQuark quark; #define XrmStringToNameList(str, name)  XrmStringToQuarkList((str), (name)) #define XrmStringToClassList(str,class) XrmStringToQuarkList((str), (class)) void XrmStringToQuarkList(string, quarks_return)
     char ∗string;
     XrmQuarkList quarks_return; XrmStringToBindingQuarkList(string, bindings_return, quarks_return)
     char ∗string;
     XrmBindingList bindings_return;
     XrmQuarkList quarks_return;

引数

bindings_return
バインディングリストを返します。

quark同等文字列を求めたいクォークを指定します。

quarks_return
クォークのリストを返します。

stringクォークまたはクォークリストが割り当てられる文字列を指定します。

解説

XrmUniqueQuark 関数は、リソースマネジャに知られているどんな文字列も表現しないと 保証されるクォークを割り当てます。 これらの関数を使用して、 文字列からクォーク表現への変換をすることができます。 文字列がホストポータブル文字コード (Host Portable Character Encoding) でない場合は、 変換はインプリメンテーションにより異なります。 XrmStringToQuark への文字列の引数に、 永久的に保存場所を割り当てる必要はありません。 XrmPermStringToQuark は、 Xlib が文字列の引数を永久的に割り当てられたものと想定して、 それを XrmQuarkToString が返す値として使用できる点を除いて、 XrmStringToQuark と同じです。 この関数は、クォーク表現から文字列へ変換するのに使用されます。 リターン値により示される文字列は、変更または解放してはいけません。 返される文字列は、 バイト単位で、 文字列からクォークへの変換ルーチンに渡された元の文字列と同じです。 そのクォークに対して何の文字列も存在しない場合は、 XrmQuarkToString は NULL を返します。 XrmQuarkToString がナル以外の値を返す場合は、 指定したクォークに対して、 以後の呼び出しは全て、同じ値 (同一のアドレス) を返します。 これらの関数は、文字列からクォーク表現を変換するのに使用されます。 文字列がホストポータブル文字コード (Host Portable Character Encoding) にない場合は、変換はインプリメンテーションにより異なります。 XrmStringToQuark への文字列の引数は、永久的に割り当てられる必要はありません。 文字列の引数が永久的に割り当てられるのを Xlib では許されていて、 そのため、 XrmQuarkToString が返す値として使用できる点を除いて、 XrmPermStringToQuark は、 XrmStringToQuark と同じです。 XrmStringToQuarkList 関数は、ナルで終わる文字列 (一般には、完全に修飾された名前) を、 クォークのリストへ変換します。 文字列は、ResourceName フォーマット準拠で なければなりません (15.1 節参照)。 文字列がホストポータブル文字コード (Host Portable Character Encoding) にない場合は、変換はインプリメンテーションにより異なります。 バインディングリストは、 XrmBindingList タイプのリストであり、 名前または分類リストが、厳しくバインディングされているか、 または、あまくバインディングされている (つまり、構成要素の中で、ワイルドカードが指定されている) かを示します。

typedef enum {XrmBindTightly, XrmBindLoosely} XrmBinding, ∗XrmBindingList;

XrmBindTightly は、ピリオドが構成要素を区切ることを示し、 XrmBindLoosely は、アスタリスクが構成要素を区切ることを示します。 XrmStringToBindingQuarkList 関数は、指定された文字列を、 バインディングリストおよびクォークリストに変換します。 文字列がホストポータブル文字コード (Host Portable Character Encoding) にない場合は、変換はインプリメンテーションにより異なります。 リスト中の構成要素名は、ピリオドまたはアスタリスク文字により区切られます。 文字列がピリオドまたはアスタリスクで始まらない場合は、 ピリオドが仮定されます。 例えば、“∗a.b∗c” は、以下のようになります。

クォークabc
バインディングあまい厳しいあまい

関連事項

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

NEWS-OSRelease 4.2.1R