Zilog Z8F0130 - Manual (Page 329)

UM013037-1212 INCLUDE
Zilog Developer Studio II – Z8 Encore!
User Manual
305
name EQU cannot be exported. In the following example, length , width , and area can be
exported, but myreg cannot.
Synonyms
.equ , .EQU , EQUAL , .EQUAL
Syntax
<label> EQU <expression>
Examples
length EQU 6 ; first dimension of rectangle

width EQU 11; second dimension of rectangle

area EQU length * width; area of the rectangle

myreg EQU rr4 ; symbolic name of a register pair
INCLUDE
Allows the insertion of source code from another file into the current source file during
assembly. The included file is assembled into the current source file immediately after the
directive. When the EOF (End of File) of the included file is reached, the assembly
resumes on the line after the
INCLUDE directive.
The file to include is named in the string constant after the INCLUDE directive. The file
name can contain a path. If the file does not exist, an error results and the assembly is
aborted. A recursive
INCLUDE also results in an error.
INCLUDE files are contained in the listing ( .lst ) file unless a NOLIST directive is active.
Synonyms
.include , .copy, copy
Syntax
<include_directive> => INCLUDE [<string_const>]
Examples
INCLUDE "calc.inc" ; include calc header file

INCLUDE "\test\calc.inc" ; contains a path name

INCLUDE calc.inc ; ERROR, use string constant