---
name: "XtConvert"
section: "3x"
platform: "linux"
package: "libxt-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/XtConvert/3x"
---

# XtConvert(3x)

invoke resource converters

## NAME

XtConvert, XtDirectConvert - invoke resource converters

## SYNTAX

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

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

## ARGUMENTS

the conversion (often NULL)

- *args*

  Specifies the argument list that contains the additional arguments needed to perform.

- *converter*

  Specifies the conversion procedure that is to be called.

- *from*

  Specifies the value to be converted.

- *from\_type*

  Specifies the source type.

- *num\_args*

  Specifies the number of additional arguments (often zero).

- *to\_type*

  Specifies the destination type.

- *to\_return*

  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*. *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

XtAppAddConverter(3Xt), XtStringConversionWarning(3Xt), XtConvertAndStore(3Xt), XtCallConverter(3Xt)\
 *X Toolkit Intrinsics - C Language Interface*\
 *Xlib - C Language X Interface*