XtConvert(3Xt)             XT FUNCTIONS            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 con-
                 version (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 argu-
                 ments (if any are needed).

DESCRIPTION
       The XtConvert function looks up the type converter regis-
       tered to convert from_type to to_type, computes any addi-
       tional 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



X Version 11                Release 3                           1

XtConvert(3Xt)             XT FUNCTIONS            XtConvert(3Xt)


       address to NULL.  To determine if the conversion was suc-
       cessful, 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

















































X Version 11                Release 3                           2