28.2.131 __builtin_tbloffset

Architecture

dsPIC33C/E/F, dsPIC30

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 9.10 Variable Attributes.

Prototype

uint16_t __builtin_tbloffset(const void *p);

Argument

p – literal address of an object

Return Value

Returns the table page number offset of the object whose address is given as a parameter.

Assembler Operator

tbloffset

Error Messages

The following error message is produced when this function is used incorrectly:

“Argument to __builtin_tbloffset() 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:

uint16_t page = __builtin_tbloffset(&obj);