|void||Define_Alias (const char *name, const char *expansion)|
|Permits a "shorthand" name to be used in place of a longer proper name of a segment. More...|
|void||UnDefine_Alias (const char *name)|
|Removes all settings established by a previous call to Define_Alias(). More...|
|void Define_Alias||(||const char *||name,|
|const char *||expansion|
Permits a "shorthand" name to be used in place of a longer proper name of a segment.
name - Simple name to be added to the list of definitions. expansion - The literal and precise string of characters that should be substituted for name.
Sometimes full segment tree names will get too lengthy to carry around. Sometimes a utility package would like to define or refer to a fixed special segment name (for example, "?Active Window"). Or sometimes you might want to hide unnecessary details (such as a special name required for the current hardcopy device) from the higher levels of your program. In such cases, Define_Alias() allows you to establish substitutions to be made. All aliases begin with a "?", and all names that begin with a "?" in a segment specification must be in the system's list of aliases.
The expansion of an alias can include wildcard characters, references to other names, or anything you want. The expansion is substituted literally when the alias is encountered and execution continues. At definition time, the expansion is simply recorded.
The defined name must include the leading "?".
A warning is given for redefining an already existing name.