13.07.2015 Views

TASKING VX-toolset for ARM User Guide

TASKING VX-toolset for ARM User Guide

TASKING VX-toolset for ARM User Guide

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>TASKING</strong> <strong>VX</strong>-<strong>toolset</strong> <strong>for</strong> <strong>ARM</strong> <strong>User</strong> <strong>Guide</strong>.INCLUDESyntax.INCLUDE "filename" | DescriptionWith the .INCLUDE directive you include another file at the exact location where the .INCLUDE occurs.This happens be<strong>for</strong>e the resulting file is assembled. The .INCLUDE directive works similarly to the#include statement in C. The source from the include file is assembled as if it followed the point of the.INCLUDE directive. When the end of the included file is reached, assembly of the original file continues.The string specifies the filename of the file to be included. The filename must be compatible with theoperating system (<strong>for</strong>ward/backward slashes) and can contain a directory specification. If you omit afilename extension, the assembler assumes the extension .asm.If an absolute pathname is specified, the assembler searches <strong>for</strong> that file. If a relative path is specifiedor just a filename, the order in which the assembler searches <strong>for</strong> include files is:1. The current directory if you use the "filename" construction.The current directory is not searched if you use the syntax.2. The path that is specified with the assembler option --include-directory.3. The path that is specified in the environment variable AS<strong>ARM</strong>INC when the product was installed.4. The default include directory in the installation directory.The assembler does not allow a label with this directive.The state of the assembler is not changed when an include file is processed. The lines of the include fileare inserted just as if they belong to the file where it is included.ExampleSuppose that your assembly source file test.src contains the following line:.INCLUDE "c:\myincludes\myinc.inc"The assembler issues an error if it cannot find the file at the specified location..INCLUDE "myinc.inc"The assembler searches the file myinc.inc according to the rules described above.Related In<strong>for</strong>mationAssembler option --include-directory (Add directory to include file search path)118

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!