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

Prototype

uint16_t __builtin_tblpage(const void *p);

Argument

p – literal address of an object

Return Value

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

Assembler Operator

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:

uint16_t page = __builtin_tblpage(&obj);