c_getalias - Retrieves the value of an alias name

SYNTAX

#include "las.h"

FUNCTION c_getalias (instring,outstring);

     char           *instring,
                    *outstring;

PARAMETERS

instring (input, character, length(*))

The input string containing the alias name. An alias name is indicated by a "$".

outstring (output, character, length(*))

The output string which contains the substituted value of the alias name.

DESCRIPTION

c_getalias() is used to retrieve an alias name and substitute the value defined in an alias name table into the output string. The input string is searched for a "$", if any are encountered (indicating an alias name), then the retrieved alias text is substituted for the alias name and returned in the output string. The input string is returned in the output string when the input string contains no alias name. Because the alias name has no termination character, it is assumed to be terminated by the end of the input string or by the occurrence of any nonalphanumeric character. An alias name must also be a maximum of nine characters long.

RETURN VALUE

c_getalias() returns

     E_SUCC (0) --> successful substitution of alias name, if any
     E_FAIL (-1) --> error in the alias name