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 XC32
 C Compiler User's Guide (section 28.2) for more detail.

Table 28-1. Built-in Function List
Built-in Name and Link	Built-in Name and Link	Built-in Name and Link
28.2.1 __builtin_add_16	28.2.27 __builtin_flim_excess_32	28.2.56 __builtin_mulsu_32
28.2.2 __builtin_add_32	28.2.28 __builtin_flimv_excess_32	28.2.57 __builtin_mulus_16
28.2.3 __builtin_and_FCR	28.2.32 __builtin_fmax	28.2.58 __builtin_mulus_32
28.2.4 __builtin_btg_32	28.2.33 __builtin_fmax_excess	28.2.59 __builtin_muluu_16
__builtin_clr	28.2.34 __builtin_fmaxv_excess	28.2.60 __builtin_muluu_32
28.2.6 __builtin_div_3216	28.2.35 __builtin_fmin	28.2.61 __builtin_pwrsav
28.2.7 __builtin_divf_16	28.2.36 __builtin_fmin_excess	28.2.62 __builtin_repeat_nop
28.2.8 __builtin_divf_32	28.2.37 __builtin_fminv_excess	28.2.63 __builtin_sac_16
28.2.9 __builtin_divf_3216	28.2.38 __builtin_get_isr_state	28.2.64 __builtin_sac_32
28.2.10 __builtin_divmod_3216	28.2.39 __builtin_ior_FCR	28.2.65 __builtin_sacr_16
28.2.11 __builtin_divmodf, __builtin_divmodf_32	28.2.40 __builtin_lac_16	28.2.66 __builtin_sacr_32
28.2.12 __builtin_divmodf_16	28.2.41 __builtin_lac_32	28.2.67 __builtin_sat_abs_s16
28.2.13 __builtin_divmodf_3216	28.2.42 __builtin_mac_16	28.2.68 __builtin_sat_add_s16
28.2.14 __builtin_ed_16	28.2.43 __builtin_mac_32	28.2.69 __builtin_sat_sub_s16
28.2.15 __builtin_ed_32	28.2.44 __builtin_max_16, __builtin_max_32	28.2.70 __builtin_set_isr_state
28.2.16 __builtin_edac_16	28.2.45 __builtin_min_16, __builtin_min_32	28.2.72 __builtin_sftac
28.2.17 __builtin_edac_32	28.2.46 __builtin_mod_3216	28.2.74 __builtin_set_FCR
28.2.18 __builtin_fbcl	28.2.47 __builtin_mpy_16	28.2.75 __builtin_swap_32
28.2.19 __builtin_fbcl_16	28.2.48 __builtin_mpy_32	28.2.76 __builtin_udiv
28.2.20 __builtin_fbcl_32	28.2.49 __builtin_mpyn_16	28.2.77 __builtin_udivmod_3216
28.2.21 __builtin_ff1l, __builtin_ff1r	28.2.50 __builtin_mpyn_32	28.2.78 __builtin_umod_3216
28.2.22 __builtin_ff1l_16	28.2.51 __builtin_msc_16	28.2.79 __builtin_write_ACCH
28.2.23 __builtin_ff1l_32	28.2.52 __builtin_msc_32	28.2.80 __builtin_write_ACCL
28.2.24 __builtin_ff1r_16	28.2.53 __builtin_mulss_16	28.2.81 __builtin_write_ACCU
28.2.25 __builtin_ff1r_32	28.2.54 __builtin_mulss_32	28.2.82 __builtin_write_DISICTL
28.2.26 __builtin_flim_32	28.2.55 __builtin_mulsu_16