__builtin_software_breakpoint Builtin

A builtin function that triggers a software breakpoint.

Include

<xc.h>

Prototype

void __builtin_software_breakpoint(void);

Remarks

This is an inbuilt function that is expanded by the code generator. When called, this routine unconditionally triggers a software breakpoint when the code is executed using a debugger.

The software breakpoint code is only generated for mid-range and PIC18 devices. Baseline devices do not support software breakpoints in this way, and the builtin will be ignored if used with these devices.

Example

#include <xc.h>

int main (void)
{
  __builtin_software_breakpoint();    // stop here
}