mirror of
https://github.com/boostorg/multiprecision.git
synced 2026-01-19 04:22:11 +00:00
55bf069621
* Update Jamfile.v2 * Update introduction.qbk * Update tutorial.qbk * Update tutorial_cpp_int.qbk * Update tutorial_gmp_int.qbk * Update tutorial_tommath.qbk * Update integer_examples.cpp * Update tutorial_cpp_bin_float.qbk * Update tutorial_cpp_dec_float.qbk * Update tutorial_gmp_float.qbk * Update tutorial_mpfr_float.qbk * Update tutorial_float128.qbk * Update tutorial_float_builtin_ctor.qbk * Update big_seventh.cpp * Update tutorial_float_eg.qbk * Update floating_point_examples.cpp * Update mpfr_precision.cpp * Update gauss_laguerre_quadrature.cpp * Update tutorial_interval_mpfi.qbk * Update tutorial_cpp_complex.qbk * Update tutorial_mpc_complex.qbk * Update tutorial_float128_complex.qbk * Update tutorial_complex_adaptor.qbk * Update tutorial_rational.qbk * Update tutorial_tommath_rational.qbk * Update tutorial_logged_adaptor.qbk * Update tutorial_debug_adaptor.qbk * Update tutorial_visualizers.qbk * Update tutorial_fwd.qbk * Update tutorial_conversions.qbk * Update tutorial_random.qbk * Update random_snips.cpp * Update tutorial_constexpr.qbk * Update tutorial_import_export.qbk * Update cpp_int_import_export.cpp * Update tutorial_mixed_precision.qbk * Update tutorial_variable_precision.qbk * Update scoped_precision_example.cpp * Update tutorial_numeric_limits.qbk * Update tutorial_numeric_limits.qbk * Update numeric_limits_snips.cpp * Update numeric_limits_snips.cpp * Update tutorial_numeric_limits.qbk * Update numeric_limits_snips.cpp * Update numeric_limits_snips.cpp * Update tutorial_io.qbk * Update reference_number.qbk * Update reference_cpp_bin_float.qbk * Update reference_cpp_double_fp_backend.qbk * Update reference_internal_support.qbk * Update reference_backend_requirements.qbk * Update performance.qbk * Update performance_overhead.qbk * Update performance_real_world.qbk * Update performance_integer_real_world.qbk * Update performance_rational_real_world.qbk * Update reference_number.qbk * Update tutorial_numeric_limits.qbk * Update reference_backend_requirements.qbk
52 lines
1.9 KiB
Plaintext
52 lines
1.9 KiB
Plaintext
[/
|
|
Copyright 2011 - 2020 John Maddock.
|
|
Copyright 2013 - 2019 Paul A. Bristow.
|
|
Copyright 2013 Christopher Kormanyos.
|
|
|
|
Distributed under the Boost Software License, Version 1.0.
|
|
(See accompanying file LICENSE_1_0.txt or copy at
|
|
http://www.boost.org/LICENSE_1_0.txt).
|
|
]
|
|
|
|
[section:debug_adaptor debug_adaptor]
|
|
|
|
`#include <boost/multiprecision/debug_adaptor.hpp>`
|
|
|
|
namespace boost{ namespace multiprecision{
|
|
|
|
template <Backend>
|
|
class debug_adaptor;
|
|
|
|
template <class Number>
|
|
using debug_adaptor_t = number<debug_adaptor<typename Number::backend_type>, Number::et>
|
|
|
|
}} // namespaces
|
|
|
|
The `debug_adaptor` type is used in conjunction with `number` and some other backend type: it acts as a thin wrapper around
|
|
some other backend to class `number` and intercepts all operations on that object storing the result as a string within itself.
|
|
|
|
This type provides `numeric_limits` support whenever the template argument Backend does so.
|
|
|
|
This type is particularly useful when your debugger provides a good view of `std::string`: when this is the case
|
|
multiprecision values can easily be inspected in the debugger by looking at the `debug_value` member of `debug_adaptor`.
|
|
The down side of this approach is that runtimes are much slower when using this type. Set against that it can make
|
|
debugging very much easier, certainly much easier than sprinkling code with `printf` statements.
|
|
|
|
You will need to expand out the view and look at the "debug_value" member:
|
|
|
|
[$../debugger2.png]
|
|
|
|
It works for all the backend types equally too, here it is inspecting a `number<debug_adaptor<gmp_rational> >`:
|
|
|
|
[$../debugger3.png]
|
|
|
|
The template alias `debug_adaptor_t` is used as a shortcut for converting some other number type to its debugged equivalent,
|
|
for example:
|
|
|
|
using mpfr_float_debug = debug_adaptor_t<mpfr_float>;
|
|
|
|
Defines `mpfr_float_debug` to be the debugged equivalent of `mpfr_float`.
|
|
|
|
|
|
[endsect] [/section:debug_adaptor debug_adaptor]
|