DragonFly On-Line Manual Pages

EZ_InstallSymbol()                                          EZ_InstallSymbol()

NAME
       EZ_InstallSymbol, EZ_RetrieveSymbol - install/retrieve a symbolic
       constant to/from the resource database

SYNOPSIS
       #include <EZ.h>

       int EZ_InstallSymbol(char *name, EZ_Value value)

       EZ_Value *EZ_RetrieveSymbol(char *name)

ARGUMENTS
       name  Specifies a name.

       value  Specifies a value to be associated with name.

DESCRIPTION
       EZ_InstallSymbol installs the key-value pair (name, value) into an
       internal lookup table.  It is a tool for converting resource values to
       other data types. This function returns -1 if it fails.

       value is defined by the following data structure.
       typedef struct {
          int        type; /* EZ_INT, EZ_FLOAT, EZ_POINTER or EZ_ULONG */
          union {
            int   i;
            float f;
            void  *p;
            ulong l;
          }          value;
       } EZ_Value;

       EZ_RetrieveSymbol retrieves and returns the value for name.  If name is
       not found in the table, it returns NULL.

       The following (integer) symbols are installed by EZ_InitializeXrm

       ( "no",                 0)
       ( "yes",                1)
       ( "No",                 0)
       ( "Yes",                1)
       ( "null",               0)
       ( "Null",               0)
       ( "false",              0)
       ( "true",               1)
       ( "False",              0)
       ( "True",               1)
       ( "on",                 1)
       ( "off",                0)
       ( "On",                 1)
       ( "Off",                0)
       ( "none",               0)
       ( "None",               0)
       ( "nil",                0)
       ( "horizontal",         1)
       ( "horizontalLeft",     2)
       ( "horizontalRight",    3)
       ( "horizontalCenter",   4)
       ( "vertical",           5)
       ( "verticalTop",        6)
       ( "verticalBottom",     7)
       ( "verticalCenter",     8)
       ( "fillNone",           0)
       ( "fillHorizontally",   1)
       ( "fillVertically",     2)
       ( "fillBoth",           3)
       ( "center",             0)
       ( "left",               1)
       ( "right",              2)
       ( "top",                3)
       ( "bottom",             4)
       ( "topLeft",            5)
       ( "topRight",           6)
       ( "bottomLeft",         7)
       ( "bottomRight",        8)
       ( "row",                1)
       ( "column",             2)
       ( "flat",               1)
       ( "ridge",              2)
       ( "groove",             3)
       ( "raised",             4)
       ( "sunken",             5)
       ( "embossed",           8)
       ( "engraved",           9)
       ( "normalState",        1)
       ( "iconicState",        3)
       ( "empty",              0)
       ( "square",             1)
       ( "sunkenSquare",       2)
       ( "diamond",            3)
       ( "sunkenDiamond",      4)
       ( "circle",             5)
       ( "check",              6)
       ( "rectangle",          7)

SEE ALSO
       EZ_InstallSymbolicInt(3), EZ_InstallSymbolicPointer(3),
       EZ_GetApplicationResource(3)

EZWGL Functions                      EZWGL                  EZ_InstallSymbol()