28.2.61 __builtin_tbladdress

Description

Returns a value that represents the address of an object in program memory. 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 long __builtin_tbladdress(const void *p);

Argument

p object address

Return Value

Returns an unsigned long value that represents the address of an object in program memory.

Assembler Operator/ Machine Instruction

tbladdress

Error Messages

The following error message is produced when this function is used incorrectly: “Argument to __builtin_tbladdress() 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 long page = __builtin_tbladdress(&obj);