GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTVAREGISTERSYMBOLS (3)

NAME

XmtVaRegisterSymbols(), XmtLookupSymbol() - register a name for application variables, and lookup variables by name.

CONTENTS

SYNOPSIS

   #include <Xmt/Symbols.h>

   void XmtVaRegisterSymbols(String name, String type, int size, XtPointer address,
{ String name, String type, int size, XtPointer a ddress, }
NULL)

   XmtSymbol XmtLookupSymbol(String name)

ARGUMENTS

INPUTS
name The name of a symbol to be registered, or looked up. For XmtVaRegisterSymbols() this argument may appear any number of times as part of a NULL terminated variable-length argument list.
type The representation type of the variable to be registered. This argument may appear any number of times as part of a NULL-terminated variable-length argument list.
size The size, in bytes, of the variable to be registered. This argument may appear any number of times as part of a NULL-terminated variable-length argument list.
address The address of the variable to be registered. This argument may appear any number of times as part of a NULL-terminated variable-length argument list.

RETURNS

XmtLookupSymbol() returns the opaque XmtSymbol structure created when the named symbol was registered.

DESCRIPTION

XmtVaRegisterSymbols() lets you register symbolic names for application variables. It takes a NULL-terminated list of (name, type, size, address) quadruples. For each set of values, it registers name as the symbolic name for the variable at address with size size and representation type type.

Both of the String arguments, name and type must be constant strings, or at least permanently allocated strings-the symbol registration function does not make copies of these strings, so they must not be in memory that will be freed, nor in memory on the stack. Similarly, of course, you will want the address argument to be the address of a static or global variable, or at least the address of memory that has been allocated and will never be freed.

XmtLookupSymbol() looks up an XmtSymbol structure for a named symbol. The XmtSymbol is an internal representation that is created when symbols are registered. It can be used with other symbol manipulation functions.

SEE ALSO

Chapter 12, Symbols,
XmtSymbolAddCallback(), XmtSymbolGetValue(), XmtSymbolRemoveCallback(), XmtSymbolSetValue().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTVAREGISTERSYMBOLS (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.