MirBSD manpage: XtCallConverter(3), XtConvertAndStore(3)


XtConvertAndStore(3Xt)    XT FUNCTIONS     XtConvertAndStore(3Xt)

NAME

     XtConvertAndStore, XtCallConverter - invoke resource con-
     verters

SYNTAX

     Boolean XtConvertAndStore(Widget widget, String from_type,
          XrmValuePtr from, String to_type, XrmValuePtr
          to_in_out);

     Boolean XtCallConverter(Display* dpy, XtConverter converter,
          XrmValuePtr args, Cardinal num_args, XrmValuePtr from,
          XrmValuePtr to_in_out, XtCacheRef* cache_ref_return);

ARGUMENTS

     args      Specifies the argument list that contains the
               additional arguments needed to perform the conver-
               sion, or NULL.

     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_in_out Returns the converted value.

     widget    Specifies the widget to use for additional argu-
               ments, if any are needed, and the destroy callback
               list.

     dpy       Specifies the display with which the conversion is
               to be associated.

DESCRIPTION

     The XtConvertAndStore function looks up the type converter
     registered to convert from_type to to_type, computes any
     additional arguments needed, and then calls XtCallConverter.
     (or XtDirectConvert if an old-style converter was registered
     with XtAddConverter or XtAppAddConverter. ) with the from
     and to_in_out arguments.

     The XtCallConverter function looks up the specified type
     converter in the application context associated with the
     display and, if the converter was not registered or was
     registered with cache type XtCacheAll or XtCacheByDisplay
     looks in the conversion cache to see if this conversion

XFree86                   Version 4.5.0                         1

XtConvertAndStore(3Xt)    XT FUNCTIONS     XtConvertAndStore(3Xt)

     procedure has been called with the specified conversion
     arguments. If so, it checks the success status of the prior
     call, and if the conversion failed, XtCallConverter returns
     False immediately; otherwise it checks the size specified in
     the to argument and, if it is greater than or equal to the
     size stored in the cache, copies the information stored in
     the cache into the location specified by to->addr, stores
     the cache size into to->size, and returns True. If the size
     specified in the to argument is smaller than the size stored
     in the cache, XtCallConverter copies the cache size into the
     to->size and returns False. If the converter was registered
     with cache type XtCacheNone or no value was found in the
     conversion cache, XtCallConverter calls the converter and,
     if it was not registered with cache type XtCacheNone, enters
     the result into the cache. XtCallConverter then returns what
     the converter returned.

     The cache_ref_return field specifies storage allocated by
     the caller in which an opaque value will be stored. If the
     type converter has been registered with the XtCacheRefCount
     modifier and if the value returned in in cache_ref_return is
     non-NULL, then the call should store the cache_ref_return
     value in order to decrement the reference count when the
     converted value is no longer required. The cache_ref_return
     argument should be ULL if the caller is unwilling or unable
     to store the value.

SEE ALSO

     XtAppReleaseCacheRefs(3Xt)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

XFree86                   Version 4.5.0                         2

Generated on 2021-12-07 11:07:08 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.