Add example of the bit conversions

Author: mborland

examples/bit_conversions.cpp

@@ -0,0 +1,25 @@
+// Copyright 2024 Matt Borland
+// Distributed under the Boost Software License, Version 1.0.
+// https://www.boost.org/LICENSE_1_0.txt
+
+#include <boost/decimal.hpp>
+#include <iostream>
+#include <iomanip>
+
+using namespace boost::decimal;
+
+int main()
+{
+    const decimal32_fast fast_type {5};
+    const std::uint32_t BID_bits {to_bid(fast_type)};
+    const std::uint32_t DPD_bits {to_dpd(fast_type)};
+
+    std::cout << std::hex
+              << "BID format: " << BID_bits << '\n'
+              << "DPD format: " << DPD_bits << std::endl;
+
+    const decimal32 bid_decimal {from_bid<decimal32>(BID_bits)};
+    const decimal32 dpd_decimal {from_dpd<decimal32>(DPD_bits)};
+
+    return !(bid_decimal == dpd_decimal);
+}

test/Jamfile

@@ -148,6 +148,7 @@ run test_zeta.cpp ;
 # Run the examples too
 run ../examples/adl.cpp ;
 run ../examples/basic_construction.cpp ;
+run ../examples/bit_conversions.cpp ;
 run ../examples/charconv.cpp ;
 run ../examples/literals.cpp ;
 run ../examples/rounding_mode.cpp ;