|
hpx::diagnostic_information — Extract the diagnostic information embedded in the given exception and return a string holding a formatted message.
// In header: <hpx/exception.hpp> std::string diagnostic_information(hpx::exception const & e);
The function hpx::diagnostic_information can be used to extract all diagnostic information stored in the given exception instance as a formatted string. This simplifies debug output as it composes the diagnostics into one, easy to use function call. This includes the name of the source file and line number, the sequence number of the OS-thread and the HPX-thread id, the locality id and the stack backtrace of the point where the original exception was thrown.
See Also:
hpx::get_error_locality_id(), hpx::get_error_host_name(), hpx::get_error_process_id(), hpx::get_error_function_name(), hpx::get_error_file_name(), hpx::get_error_line_number(), hpx::get_error_os_thread(), hpx::get_error_thread_id(), hpx::get_error_thread_description(), hpx::get_error(), hpx::get_error_backtrace(), hpx::get_error_env(), hpx::get_error_what(), hpx::get_error_config()
Parameters: |
|
||
Returns: |
The formatted string holding all of the available diagnostic information stored in the given exception instance. |
||
Throws: |
std::bad_alloc (if any of the required allocation operations fail) |