std::breakpoint

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Macros de prueba de característica de la biblioteca (C++20) Servicios de programa Funciones variádicas initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Apoyo de corrutinas (C++20) Apoyo de contratos (C++26) Comparación de tres vías (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits (C++20) bitset hash (C++11) Operadores relacionales (en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Control de errores

Control de excepciones exception uncaught_exceptionuncaught_exceptions (hasta 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) Fallas del control de excepciones terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (hasta C++17) unexpected_handler (hasta C++17) get_unexpected (C++11)(hasta C++17) set_unexpected (hasta C++17) Códigos de error Códigos de error errno

Categorías de excepciones logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) Aserciones assert Facilidad 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)

 

Definido en el archivo de encabezado <debugging>
void breakpoint() noexcept;		(desde C++26)

Punto de interrupción incondicional: intenta detener temporalmente la ejecución del programa y transferir el control al depurador, independientemente de si se puede detectar la presencia de un depurador. El comportamiento de esta función está definido por la implementación.

Notas

El propósito de esta función es permitir el control de los puntos de interrupción en tiempo de ejecución más allá de lo que ofrece un depurador, sin provocar la finalización del programa. Por ejemplo: detener la ejecución cuando se detecta una condición poco frecuente y no crítica; permitir un control programático basado en condiciones complejas evaluadas en tiempo de ejecución; detener la ejecución ante una entrada del usuario para inspeccionar el contexto en programas interactivos sin necesidad de cambiar a la aplicación del depurador, etc.

Esta función estandariza muchas herramientas similares ya existentes: __builtin_debugtrap de LLVM, __debugbreak de la API de Win32, debugger_break de boost.test, assert(false), _asm { int 3 } (MSVC) y asm("int3") (GCC/clang) para arquitecturas x86, etc..

Macro de prueba de característica
__cpp_lib_debugging	202311L	(C++26)	Biblioteca de apoyo para depuración.
202403L	(C++26)	std::is_debugger_present reemplazable.

Véase también

is_debugger_present (C++26)	Comprueba si un programa se está ejecutando bajo el control de un depurador. (función)
breakpoint_if_debugging (C++26)	Llama a std::breakpoint si std::is_debugger_present devuelve true. (función)

Enlaces externos

	armKEIL: Función intrínseca __breakpoint
	Portable Snippets: Aserciones y trampas de depuración
	EASTL: EASTL_DEBUG_BREAK
	Catch2: CATCH_TRAP y CATCH_BREAK_INTO_DEBUGGER
	Unreal Engine: DebugBreak
	JUCE: JUCE_BREAK_IN_DEBUGGER
	Estimado ImGui: IM_DEBUG_BREAK
	AWS C Common: aws_debug_break