Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmtSymbolSetValue(3)	    Library Functions Manual	    XmtSymbolSetValue(3)

NAME
     XmtSymbolSetValue(), XmtSymbolGetValue() - set or query the value of a sym-
     bol.

SYNOPSIS
     #include <Xmt/Symbols.h>

     void XmtSymbolSetValue(XmtSymbol s, XtArgVal value)

     void XmtSymbolGetValue(XmtSymbol s, XtArgVal *valuep)

ARGUMENTS
     INPUTS

	  s	 The XmtSymbol that is to have its value queried or set.

	  value  For XmtSymbolSetValue(), the new value for the symbol.

     OUTPUTS

	  valuep For  XmtSymbolGetValue(),  the  address  at  which to store the
		 value of the symbol.

DESCRIPTION
     XmtSymbolSetValue() sets the value of symbol s to value.	Recall	that  an
     XtArgVal is the type used by Xt for untyped values passed to XtSetArg(). As
     when  you	are  setting  resources, you should pass the value itself, if it
     will fit within an XtArgVal, and otherwise, you should pass the address  of
     the value (you rarely have to do this, however, except when you are using a
     double  value.) Also, notice that XmtRBuffer is a special case here-you al-
     ways pass the address of the buffer, no matter its size.

     XmtSymbolGetValue() stores the current value of the symbol s at the address
     specified by value. Note that valuep need not actually be the address of an
     XtArgVal variable, but must be large enough to store the value of the  Sym-
     bol-you  must  know  the type of the symbol in order to pass an appropriate
     val uep.

     Note that the module that registers a symbol can obtain that symbol's value
     by reading it directly from the address registered with the symbol-there is
     no need to read it indirectly with XmtSymbolGetValue().

SEE ALSO
     Chapter 12, Symbols,
     XmtLookupSymbol(), XmtSymbolAddCallback(), XmtSymbolRemove Callback(),
     XmtVaRegisterSymbols().

Xmt				   Motif Tools		    XmtSymbolSetValue(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtSymbolSetValue&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help