User manual

ST Assembler-Linker Assembler directives
Doc ID 11392 Rev 4 57/89
Table 23. CEQU
Purpose Equate pre-existing label to expression.
Format
label CEQU <exp>
Description
This directive is similar to EQU, but allows to change the label's value. Used in macros
and as counter for REPEAT / UNTIL.
Example lab1 CEQU {lab1+1} ; inc lab1
See also EQU, REPEAT, UNTIL
Table 24. .CTRL
Purpose Send control codes to the printer.
Format
.CTRL <ctrl>[,<ctrl>]...
Description
This directive is used to send printing and non printing control codes to the selected
listing device. It's intended for sending control codes to embolden or underline, etc.
areas of listing on a printer. The arguments are sent to the listing device if the listing is
currently selected. This directive does not generate assembly code or data.
Example .CTRL 27,18
See also .LIST, .NOLIST, .BELL
Table 25. DATE
Purpose Define 12-byte ASCII date into object code.
Format
DATE
Description
This directive leaves a message for the linker to place the date of the link in a 12-byte
block the assembler leaves spare at the position of the DATE directive. This means
that every link will leave its date in the object code, allowing automatic version control.
The date takes the form (in ASCII) DD_MMM_YYYY where character '_' represents a
space; for example 18 JUL. 1988. The date is left for the linker to fill instead of the
assembler since the source code module containing the DATE directive may not be
reassembled after every editing session and it would be possible to lose track.
Example DATE
See also
Table 26. DC.B
Purpose Define byte(s) in object code.
Format DC.B <exp or "string">,[,<exp or "string">]
Description
This directive forces the byte(s) in its argument list into the object code at the current
address. The argument may be composed of complex expressions, which may even
include external labels. If the argument was an expression and had a value greater
than 255 then the lower 8 bits of the expression are used and no errors are generated.
String argument(s) must be surrounded by double-quotes: these are translated into
ASCII and processed byte by byte.
It's generally used for defining data tables. Synonymous with BYTE and STRING.