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

__builtin_psvoffset
Built-in Functions
Error Messages The following error message is produced when this function is used
incorrectly:
“Argument to __builtin_psvoffset() 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_psvoffset(&obj);
__builtin_readsfr
Description: Reads the SFR.
Prototype: unsigned int __builtin_readsfr(const void *p);
Argument: p object address
Return Value: Returns the SFR.
Assembler Operator
/ Machine
Instruction:
readsfr
Error Messages The following error message is produced when this function is used
incorrectly:
__builtin_return_address
Description: Returns the return address of the current function, or of one of its callers.
For the level argument, a value of 0 yields the return address of
the current function, a value of 1 yields the return address of the caller
of the current function, and so forth. When level exceeds the current
stack depth, 0 will be returned. This function should only be used with a
non-zero argument for debugging purposes.
Prototype: int __builtin_return_address (const int level);
Argument: level Number of frames to scan up the call stack.
Return Value: Returns the return address of the current function, or of one of its callers.
Assembler Operator
/ Machine
Instruction:
return_address
__builtin_sac
Description: Shifts value by shift (a literal between -8 and 7) and returns the
value.
For example:
register int value asm("A");
int result;
result = __builtin_sac(value,3);
Might generate:
sac A, #3, w0
Prototype: int __builtin_sac(int value, int shift);
Argument: valueInteger number to be shifted.
shiftLiteral amount to shift.
Return Value: Returns the shifted result to an accumulator.
© 2008 Microchip Technology Inc. DS51284G-page 157