Include once

Syntax

 * 1) include_once [sourcefile]

Semantics
Will read in the Mesham source file specified and will embed the contents of this source file into the code at the current location IF AND ONLY IF that specific file has not already been included before. This is a very useful mechanism to avoid duplicate includes when combining together multiple libraries.

Example

 * 1) include_once "test.mesh"
 * 2) include_once "test.mesh"

The preprocessing stage will replace the first include with the contents of test.mesh, but the second include_once will be ignored because that specific file has already been included. In the absence of the .mesh ending, the preprocessor will attempt to match on the absolute filename first and if this can not be found will then look for a file with the corresponding name and .mesh ending.

The preprocessor will search the include directories when the filename is contained in quotation marks. If contained within < > then the preprocessor will search the system include locations too which have priority.

Since: Version 1.0