28.2.62 __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 Variable Attributes.

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.

Assembler Operator/ Machine Instruction

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:

unsigned page = __builtin_tbloffset(&obj);