Chapter 8. Assembler Directives

51

.ifnes string1,string2

Like

.ifeqs

, but the sense of the test is reversed: this assembles the following section of code

if the two strings are not the same.

8.46.

.incbin "file"[,skip[,count]]

The

incbin

directive includes

file

verbatim at the current location. You can control the search

paths used with the

 I

command line option (Chapter 3 Command Line Options). Quotation marks

are required around

file

.

The

skip

argument skips a number of bytes from the start of the

file

. The

count

argument indicates

the maximum number of bytes to read. Note that the data is not aligned in any way, so it is the

user's responsibility to make sure that proper alignment is provided both before and after the

incbin

directive.

8.47.

.include "file"

This directive provides a way to include supporting files at specified points in your source program.

The code from

file

is assembled as if it followed the point of the

.include

; when the end of the

included file is reached, assembly of the original file continues. You can control the search paths used

with the

 I

command line option (Chapter 3 Command Line Options). Quotation marks are required

around

file

.

8.48.

.int expressions

Expect zero or more

expressions

, of any section, separated by commas. For each expression, emit

a number that, at run time, is the value of that expression. The byte order and bit size of the number

depends on what kind of target the assembly is for.

8.49.

.internal names

This is one of the ELF visibility directives. The other two are

.hidden

(Section 8.42

.hidden

names

) and

.protected

(Section 8.70

.protected names

).

This directive overrides the named symbols default visibility (which is set by their binding: local,

global or weak). The directive sets the visibility to

internal

which means that the symbols are

considered to be

hidden

(i.e., not visible to other components), and that some extra, processor specific

processing must also be performed upon the symbols as well.

8.50.

.irp symbol,values

. . .

Evaluate a sequence of statements assigning different values to

symbol

. The sequence of statements

starts at the

.irp

directive, and is terminated by an

.endr

directive. For each

value

,

symbol

is set to

value

, and the sequence of statements is assembled. If no

value

is listed, the sequence of statements

is assembled once, with

symbol

set to the null string. To refer to

symbol

within the sequence of

statements, use

\symbol

.

For example, assembling

.irp

param,1,2,3

move

d\param,sp@ 

.endr