28.2 Built-In Function Descriptions [DD]

This section describes the programmer interface to the compiler built-in functions.

The functions described in this section are “built in” and do not require a header file; however, we provide a file <builtins.h> that can be included to provide readable prototypes of these functions.

Also, there are no command-line switches associated with the built-in functions – they are always available. The built-in function names are chosen such that they belong to the compiler’s namespace (they all have the prefix __builtin_), so they will not conflict with function or variable names in the programmer’s namespace.

Note: If you attempt to use a built-in listed in this section with device architecture that it does not support, you will see the message below directing you to review the built-in’s architecture support.
Builtin not supported in the current configuration, please see MPLAB XC-DSC
 C Compiler User's Guide (section 28.2) for more detail.
Table 28-1. Built-in Function List
Built-in Name and LinkBuilt-in Name and LinkBuilt-in Name and Link
__builtin_ACCL, __builtin_ACCH, __builtin_ACCU__builtin_get_isr_state__builtin_sacd
__builtin_add__builtin_lac__builtin_sacr
__builtin_addab__builtin_lacd__builtin_section_begin, __builtin_section_end
__builtin_addr_low, __builtin_addr_high, __builtin_addr__builtin_lshiftrt_32_16__builtin_section_size
__builtin_ashiftrt_32_16__builtin_mac__builtin_set_isr_state
__builtin_bitcopy__builtin_max__builtin_sftac
__builtin_btg__builtin_max_excess__builtin_software_breakpoint
__builtin_clr__builtin_maxv_excess__builtin_subab
__builtin_clr_prefetch__builtin_min__builtin_swap
__builtin_clrwdt__builtin_min_excess__builtin_swap_byte
__builtin_dataflashoffset__builtin_minv_excess__builtin_tbladdress
__builtin_disable_interrupts__builtin_modsd__builtin_tbloffset
__builtin_disi__builtin_modud__builtin_tblpage
__builtin_divf__builtin_movsac__builtin_tblrdh
__builtin_divmodsd__builtin_mpy__builtin_tblrdl
__builtin_divmodud__builtin_mpyn__builtin_tblwth
__builtin_divsd__builtin_msc__builtin_tblwtl
__builtin_divud__builtin_mulss__builtin_write_CRYOTP
__builtin_dmaoffset__builtin_mulsu__builtin_write_DISICNT
__builtin_dmapage__builtin_mulus__builtin_write_NVM
__builtin_ed__builtin_muluu__builtin_write_NVM_secure
__builtin_edac__builtin_nop__builtin_write_OSCCONH
__builtin_edsoffset__builtin_popcount__builtin_write_OSCCONL
__builtin_edspage__builtin_popcountl__builtin_write_PWMSFR
__builtin_enable_interrupts__builtin_psvoffset__builtin_write_RPCON
__builtin_fbcl__builtin_psvpage__builtin_write_RTCC_WRLOCK
__builtin_flim__builtin_pwrsav__builtin_write_RTCWEN
__builtin_flim_excess__builtin_return_address
__builtin_flimv_excess__builtin_sac