Functions | |
void | Show_Alias (const char *alias, char *expansion) |
Returns the expansion of a given alias. More... | |
void Show_Alias | ( | const char * | alias, |
char * | expansion | ||
) |
Returns the expansion of a given alias.
alias | - Alias name from a previous Define_Alias() , including the initial "?". Passed by reference always. |
expansion | - The literal and precise string of characters that is equivalent to alias. Returned to user. Passed by reference always. |
Returns the string of characters that is substituted for the given alias when used in a pathname. Expansion is returned exactly as specified in the call to Define_Alias() .
Relative pathnames (e.g., ".", "^") are not resolved. Aliases within an alias definition are not expanded. Use Show_Pathname_Expansion() to show the full segment specification corresponding to an alias; use Find_Segment() ( Begin_Segment_Search() ) to see if the segment exists.
There are a few minor differences between expansion as returned here and as originally specified in Define_Alias() . Leading and trailing blanks in the alias definition will not be returned. Upper case letters will be returned in lower case. For example,
Test Segment / (ASEG, bseg) /...is returned as
test segment/(aseg, bseg)/....Also, segments defined by key value in the original Define_Alias() are always returned in uppercase, i.e., if the call was Define_Alias("?junk", "test segment/@ab12f34c") Show_Alias() will return "test segment/@AB12F34C".