Boost.Decimal

An implementation of IEEE754 Decimal Floating Point Numbers.

See more See less

/* Beats the global `[x-cloak] { display: none !important }` in styles.css. */ .hero__description-toggle[x-cloak] { display: inline-block !important; }

Documentation Source code Discuss in Slack GitHub Issues

About Boost.Decimal

Please check out the library's documentation to learn more.

View documentation

Quick Start

Boost.Decimal

	Master	Develop
Drone
Github Actions
Codecov
Fuzzing
Metal

Boost.Decimal is an implementation of IEEE 754 and ISO/IEC DTR 24733 Decimal Floating Point numbers. The library is header-only, has no dependencies, and requires C++14.

How To Use The Library

This library is header only. It contains no other dependencies. Simply #include it and use it.

CMake

git clone https://github.com/boostorg/decimal
cd decimal
mkdir build && cd build
cmake .. OR cmake .. -DCMAKE_INSTALL_PREFIX=/your/custom/path
cmake --build . --target install

then you can use find_package(boost_decimal REQUIRED)

vcpkg

Available in official vcpkg sources.

Conan

Available in official conan sources as part of the Boost distribution.

Supported Platforms

Boost.Decimal is tested natively on Ubuntu (x86_64, s390x, and aarch64), macOS (x86_64, and Apple Silicon), and Windows (x32 and x64); as well as emulated PPC64LE and ARM Cortex-M using QEMU with the following compilers:

GCC 8 and later
Clang 6 and later
Visual Studio 2019 and later
Intel OneAPI DPC++

Synopsis

Decimal provides 3 IEEE-754 compliant types:

namespace boost {
namespace decimal {

class decimal32_t;
class decimal64_t;
class decimal128_t;

} //namespace decimal
} //namespace boost

and also 3 similar but non-compliant types with improved runtime performance:

namespace boost {
namespace decimal {

class decimal_fast32_t;
class decimal_fast64_t;
class decimal_fast128_t;

} //namespace decimal
} //namespace boost

These types operate like built-in floating point types. They have their own implementations of the Standard-Library functions (e.g. like those found in <cmath>, <charconv>, <cstdlib>, etc.). The entire library can be conveniently included with #include <boost/decimal.hpp>

Using the decimal types is straightforward and can be learned by example. Their usage closely resembles that of built-in binary floating point types by design.