std::breakpoint

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Diagnostik-Bibliothek

Ausnahmebehandlung exception uncaught_exceptionuncaught_exceptions (bis C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Exception handling failures terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (bis C++17*) unexpected_handler (bis C++17*) get_unexpected (bis C++17*) set_unexpected (bis C++17*) Fehlernummern Error codes errno Assertions assert

Exception categories logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) System error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Stacktrace stacktrace_entry (C++23) basic_stacktrace (C++23) Debugging-Unterstützung is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

Definiert in der Header-Datei <debugging>
void breakpoint() noexcept;		(seit C++26)

Bedingungsloser Breakpoint: Versucht, die Programmausführung vorübergehend zu stoppen und die Kontrolle an den Debugger zu übergeben, unabhängig davon, ob die Anwesenheit eines Debuggers erkannt werden kann. Das Verhalten dieser Funktion ist implementierungsabhängig.

Hinweise

Die Absicht dieser Funktion ist es, die Laufzeitkontrolle von Breakpoints über das hinaus zu ermöglichen, was von einem Debugger verfügbar sein könnte, ohne dass das Programm beendet wird. Zum Beispiel das Brechen, wenn eine seltene nicht-kritische Bedingung erkannt wird, die programmatische Kontrolle mit komplexen laufzeitempfindlichen Bedingungen ermöglicht, das Brechen bei Benutzereingaben, um den Kontext in interaktiven Programmen zu inspizieren, ohne zum Debugger wechseln zu müssen usw.

Diese Funktion standardisiert viele ähnliche vorhandene Einrichtungen: __builtin_debugtrap von LLVM, __debugbreak aus der Win32 API, debugger_break von boost.test, assert(false), _asm { int 3 } (MSVC) und asm("int3") (GCC/clang) für x86-Ziele, usw.

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_debugging	202311L	(C++26)	Debugging-Unterstützungsbibliothek
	202403L	(C++26)	Ersetzbares std::is_debugger_present

Siehe auch

is_debugger_present (C++26)	prüft, ob ein Programm unter der Kontrolle eines Debuggers ausgeführt wird (Funktion)
breakpoint_if_debugging (C++26)	ruft std::breakpoint auf, wenn std::is_debugger_present true zurückgibt (Funktion)

Externe Links

1.	armKEIL: __breakpoint intrinsic
2.	Portable Snippets: Debugging assertions and traps
3.	EASTL: EASTL_DEBUG_BREAK
4.	Catch2: CATCH_TRAP und CATCH_BREAK_INTO_DEBUGGER
5.	Unreal Engine: DebugBreak
6.	JUCE: JUCE_BREAK_IN_DEBUGGER
7.	Dear ImGui: IM_DEBUG_BREAK
8.	AWS C Common: aws_debug_break