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

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	 XtSe-
       tArg().	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 always 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 Symbol-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  sym-
       bol-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.0>

home | help