Mac - Include

GSAK (Geocaching Swiss Army Knife)

Include (command)

INCLUDE <File=FileName>

Use this command to insert common code into a macro. It is similar, but not the same in function to the MACRO command. Instead, the command will replace this line of code with the contents of the specified file. Consider it exactly the same as if you copy then pasted the code into the original macro at this position. However, the macro file itself is not actually updated - just the contents in memory that GSAK runs. This will allow you to keep code libraries of subroutines in a single file, then get access to them via this single command. Subroutines are not global in scope, hence you can't do this same thing via the GOSUB command.

Note: the "FileName" must be a literal and not a variable. The INCLUDE command is processed by the macro pre processor (before any code is actually run) and macro variables are not resloved in this phase.
Summary