XtConvert(3Xt)                SDK X11 R4.11MU05               XtConvert(3Xt)


NAME
       XtConvert, XtDirectConvert - invoke resource converters

SYNTAX
       void XtConvert(w, fromtype, from, totype, toreturn)
           Widget w;
           String fromtype;
           XrmValuePtr from;
           String totype;
           XrmValuePtr toreturn;

       void XtDirectConvert(converter, args, numargs, from, toreturn)
           XtConverter converter;
           XrmValuePtr args;
           Cardinal numargs;
           XrmValuePtr from;
           XrmValuePtr toreturn;

ARGUMENTS
       args      Specifies the argument list that contains the additional
                 arguments 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 from_type to to_type, 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; otherwise, 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(3Xt), XtStringConversionWarning(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface


Licensed material--property of copyright holder(s)