Directives Reference
ARM DUI 0068B Copyright © 2000, 2001 ARM Limited. All r ights reserved. 7-61
7.7.10 GET or INCLUDE
The
GET
directive includes a file within the file being assembled. The included file is
assembled at the loca tion of the
GET
directive.
INCLUDE
is a synonym for
GET.
Syntax
GET filename
where:
filename
is the name of the file to be included in the assembly. The assembler
accepts pathnames in either UNIX or MS-DOS format.
Usage
GET
is useful for including macro definitions,
EQU
s, and storage maps in an assembly.
When assembly of the included file is complete, assembly continues at the line
following the
GET
directive.
By default the assem bler searches th e current place f or included files . The current pl ace
is the directory where the calling file is located. Use the
-i
assembler command-lin e
option to add directories to the search path. File names and directory names containing
spaces must not be enclosed in double quotes ( " " ).
The included file can contain additional GET directives to include other files (see
Nesting directives on page7-26).
If the included file is in a different directory from the current place, this becomes the
current place until the end of the included file. The previous current place is then
restored.
GET
cannot be used to include object files (see INCBIN on page7-63).
Example
AREA Example, CODE, READONLY
GET file1.s ; includes file1 if it exists
; in the current place.
GET c:\project\file2.s ; includes file2
GET c:\Program files\file3.s ; space is allowed