XtConvert(3) XT COMPATIBILITY FUNCTIONS XtConvert(3)

# [NAME](#NAME)

XtConvert, XtDirectConvert - invoke resource converters

# [SYNTAX](#SYNTAX)

#include <X11/Intrinsic.h>

void XtConvert(Widget *w*, const char \**from\_type*, XrmValuePtr *from*, const char \**to\_type*, XrmValuePtr *to\_return*);

void XtDirectConvert(XtConverter *converter*, XrmValuePtr *args*, Cardinal *num\_args*, XrmValuePtr *from*, XrmValuePtr *to\_return*);

# [ARGUMENTS](#ARGUMENTS)

[*args*](#args)

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

[*converter*](#converter)

Specifies the conversion procedure that is to be called.

[*from*](#from)

Specifies the value to be converted.

[*from\_type*](#from_type)

Specifies the source type.

[*num\_args*](#num_args)

Specifies the number of additional arguments (often zero).

[*to\_type*](#to_type)

Specifies the destination type.

[*to\_return*](#to_return)

Returns the converted value.

[*w*](#w)

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

# [DESCRIPTION](#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**. **XtConvert** has been replaced by **XtConvertAndStore**.

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. **XtDirectConvert** has been replaced by **XtCallConverter**.

# [SEE ALSO](#SEE_ALSO)

[XtAppAddConverter(3)](/man/os/libxt/XtAppAddConverter.3), [XtStringConversionWarning(3)](/man/os/libxt/XtStringConversionWarning.3), [XtConvertAndStore(3)](/man/os/libxt/XtConvertAndStore.3), [XtCallConverter(3)](/man/os/libxt/XtCallConverter.3)  
*X Toolkit Intrinsics - C Language Interface*  
*Xlib - C Language X Interface*

libXt 1.3.1 X Version 11

---

Document: XtDirectConvert(3) from libxt 1.3.1-r9 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxt.git