MPLAB C Compiler for PIC24 MCUs and dsPIC DSCs ... - Microchip

__builtin_subab
Built-in Functions
Description: Subtracts acumulators A and B with the result written back to the
specified accumulator. For example:
register int result asm("A");
result = __builtin_subab();
will generate:
sub A
Prototype: int __builtin_subab(void);
Argument: None
Return Value: Returns the subtraction result to an accumulator.
Assembler Opera- subad
tor / Machine
Instruction:
Error Messages An error message will be displayed if the result is not an accumulator
register.
__builtin_tblpage
Description: Returns the table page number of the object whose address is given as
a parameter. The argument p must be the address of an object in an
EE data, PSV or executable memory space; otherwise an error message
is produced and the compilation fails. See the space attribute in
Section 2.3.1 “Specifying Attributes of Variables”.
Prototype: unsigned int __builtin_tblpage(const void *p);
Argument: p object address
Return Value: Returns the table page number of the object whose address is given as
a parameter.
Assembler Operator
/ Machine
Instruction:
tblpage
Error Messages The following error message is produced when this function is used
incorrectly:
“Argument to __builtin_tblpage() is not the address of an object
in code, psv, or eedata section”.
The argument must be an explicit object address.
For example, if obj is object in an executable or read-only section, the
following syntax is valid:
unsigned page = __builtin_tblpage(&obj);
__builtin_tbloffset
Description: Returns the table page offset of the object whose address is given as a
parameter. The argument p must be the address of an object in an EE
data, PSV or executable memory space; otherwise an error message is
produced and the compilation fails. See the space attribute in
Section 2.3.1 “Specifying Attributes of Variables”.
Prototype: unsigned int __builtin_tbloffset(const void *p);
Argument: p object address
Return Value: Returns the table page number offset of the object whose address is
given as a parameter.
© 2008 Microchip Technology Inc. DS51284G-page 159