Click above to get retro games delivered to your door ever month!

The following form of the auxiliary pragma can be used to describe the
mapping of a symbol from its source form to its object form.

+--------------------------------------------------------------------------+
|      #pragma aux sym obj_name [;]                                        |
|                                                                          |
+--------------------------------------------------------------------------+

where
    description

sym
    is any valid C/C++ identifier.

obj_name
    is any character string enclosed in double quotes.

When specifying obj_name, the asterisk character ('*') has a special
meaning; it is a placeholder for sym.

In the following example, the name "myrtn" will be replaced by "myrtn_" in
the object file.


     #pragma aux myrtn "*_";

This is the default for all function names.

In the following example, the name "myvar" will be replaced by "_myvar" in
the object file.


     #pragma aux myvar "_*";

This is the default for all variable names.

The default mapping for all symbols can also be changed as illustrated by
the following example.


     #pragma aux default "_*_";

The above auxiliary pragma specifies that all names will be prefixed and
suffixed by an underscore character ('_').

The '' character also has a special meaning.  Whenever it is encountered in
obj_name, it is replaced by the upper case version of sym.

In the following example, the name "myrtn" will be replaced by "MYRTN" in
the object file.


     #pragma aux myrtn "";