Museum

 XtConvert(Xt)     X Version 11 (Release 5) 6 January 1993      XtConvert(Xt)


 Name

    XtConvert - invoke resource converters

 Syntax


    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;


 Arguments

    args      Specifies the argument list that contains the additional argu-
              ments needed to perform the conversion (often NULL).

    converter Specifies the conversion procedure that is to be called.

    from      Specifies the value to be converted.

    fromtype Specifies the source type.

    numargs  Specifies the number of additional arguments (often zero).

    totype   Specifies the destination type.

    toreturn Returns the converted value.

    w         Specifies the widget to use for additional arguments (if any
              are needed).

 Description

    The XtConvert function looks up the type converter registered to convert
    fromtype to totype, computes any additional arguments needed, and then
    calls XtDirectConvert.

    The XtDirectConvert function looks in the converter cache to see if this
    conversion procedure has been called with the specified arguments.  If
    so, it returns a descriptor for information stored in the cache; other-
    wise, it calls the converter and enters the result in the cache.

    Before calling the specified converter, XtDirectConvert sets the return
    value size to zero and the return value address to NULL.  To determine if
    the conversion was successful, the client should check to_return.address
    for non-NULL.

 See also

    XtAppAddConverter(Xt) and XtStringConversionWarning(Xt).

    X Toolkit Intrinsics - C Language Interface
    Xlib - C Language X Interface