名称

XtConvert, XtDirectConvert − リソースコンバータを呼び出す

形式

void XtConvert(w, from_type, from, to_type, to_return)
    Widget w;
    String from_type;
    XrmValuePtr from;
    String to_type;
    XrmValuePtr to_return; void XtDirectConvert(converter, args, num_args, from, to_return)
    XtConverter converter;
    XrmValuePtr args;
    Cardinal num_args;
    XrmValuePtr from;
    XrmValuePtr to_return;

引数

args変換を行うのに必要な追加の引数を含んだ 引数リストを指定します（NULL であることが多い）。

converter呼び出す変換プロシージャを指定します。

from変換する値を指定します。

from_typeソースのタイプを指定します。

num_args追加の引数の数を指定します（０であることが多い）。

to_typeデスティネーションのタイプを指定します。

to_return変換された値が返されます。

w追加の引数に使用するための ウィジェットを指定します（必要に応じて）。

解説

XtConvert 関数は、 from_type から to_type へ変換するために発信された タイプコンバータを捜し、 追加引数が必要ならばそれを用意し、 XtDirectConvert を呼び出します。 XtDirectConvert 関数は、コンバータのキャッシュを見て、すでに同じ引数でこの変換 プロシージャが呼び出されたかどうかを調べます。 もしそうであれば、キャッシュに変換結果が入っているので、 XtDirectConvert は、その情報に対するディスクリプタを返し、 そうでない場合は、実際にコンバータを呼び出し、その結果をキャッシュに 入れます。 指定されたコンバータを呼び出す前に、 XtDirectConvert は、リターン値のサイズを 0 に、リターン値のアドレスを NULL に設定します。 クライアントは、変換が成功したかどうかを、 to_return.address が 非 NULL であるかどうかによりチェックできます。

関連事項

XtAppAddConverter(3Xt), XtStringConversionWarning(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 3.3