Name

XtDirectConvert — perform resource conversion and cache result. 

Synopsis

void XtDirectConvert(converter, args, num_args, from, to_return)

    XtConverter converter;
    XrmValuePtr args;
    Cardinal num_args;
    XrmValuePtr from;
    XrmValuePtr to_return;

Arguments

converterSpecifies the conversion procedure to be called. 

argsSpecifies the argument list that contains the additional arguments needed to perform the conversion (often NULL). 

num_argsSpecifies the number of additional arguments (often zero). 

fromSpecifies the value to be converted. 

to_returnReturns the converted value. 

Description

XtDirectConvert has been superseded by XtCallConverter.  XtDirectConvert looks in the converter cache to see if the named conversion procedure has been called with the specified arguments.  If so, it returns a descriptor for information stored in the cache; otherwise, it calls 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.  If the conversion succeeds, to_return.address will be non-NULL. 

XtConvert provides a higher-level interface to XtDirectConvert.  Converters can also be invoked using the XtVaTypedArg syntax in XtVaCreateManagedWidget or XtVaSetValues. 

Structures

typedef struct {
    unsigned int size;
    caddr_t addr;
} XrmValue, ∗XrmValuePtr;

See Also

XtAppAddConverter(1), XtCallConverter(1), XtConvert(1), XtConvertAndStore(1), XtGetApplicationResources(1), XtGetSubresources(1), XtSetTypeConverter(1), XtVaCreateManagedWidget(1), XtVaSetValues(1),
XtConverter(2).