__debugbreak

Microsoft Specific

Causes a breakpoint in your code, where the user will be prompted to run the debugger.

Syntax

void __debugbreak();

Requirements

Intrinsic Architecture Header
__debugbreak x86, x64, ARM, ARM64 <intrin.h>

Remarks

The __debugbreak compiler intrinsic, similar to DebugBreak, is a portable Win32 way to cause a breakpoint.

Note

When compiling with /clr, a function containing __debugbreak will be compiled to MSIL. asm int 3 causes a function to be compiled to native. For more information, see __asm.

For example:

main() {
   __debugbreak();
}

is similar to:

main() {
   __asm {
      int 3
   }
}

on an x86 computer.

On ARM64, the __debugbreak intrinsic is compiled into the instruction brk #0xF000.

This routine is only available as an intrinsic.

END Microsoft Specific

See also

Compiler intrinsics
Keywords