Decimal.h

Go to the documentation of this file.

// Copyright Onix Solutions Limited [OnixS]. All rights reserved.
//
// This software owned by Onix Solutions Limited [OnixS] and is 
// protected by copyright law and international copyright treaties.
//
// Access to and use of the software is governed by the terms of the applicable 
// OnixS Software Services Agreement (the Agreement) and Customer end user license 
// agreements granting a non-assignable, non-transferable and non-exclusive license 
// to use the software for it's own data processing purposes under the terms defined 
// in the Agreement.
//
// Except as otherwise granted within the terms of the Agreement, copying or 
// reproduction of any part of this source code or associated reference material 
// to any other location for further reproduction or redistribution, and any 
// amendments to this copyright notice, are expressly prohibited.
//
// Any reproduction or redistribution for sale or hiring of the Software not in 
// accordance with the terms of the Agreement is a violation of copyright law.
//

#pragma once

#include <string>

#include <OnixS/CboeCFE/MarketData/Pitch/Compiler.h>
#include <OnixS/CboeCFE/MarketData/Pitch/Integral.h>

namespace OnixS
{
    namespace CboeCFE
    {
        namespace MarketData
        {
            namespace Pitch
            {

                /// Represents real number with constant exponent. 
                /// 
                /// BOE Platform currently operates prices 
                /// and scaling factors as real numbers with constant exponent. 
                /// This class implements concept of fixed point decimal and 
                /// lets to dramatically improve performance of book-related 
                /// operations. 
                template<class MantissaType, class ExponentType>
                class ONIXS_CBOECFE_PITCH_API FixedPointDecimal
                {
                    // Only mantissa is stored. 
                    MantissaType mantissa_;

                public:
                    /// Aliases mantissa component type. 
                    typedef MantissaType Mantissa;

                    /// Aliases exponent component type. 
                    typedef ExponentType Exponent;

                    /// A few traits. 
                    enum
                    {
                        /// Size of class in bytes. 
                        ///
                        /// Instantiations of given class are used 
                        /// while manipulating binary messages. Regular 
                        /// composites expose given characteristics so 
                        /// as this template class does. 
                        Size = sizeof(Mantissa)
                    };

                    /// Default (zero) initialization.
                    FixedPointDecimal()
                    ONIXS_BATS_PITCH_NOTHROW
                        : mantissa_()
                    {
                    }

                    /// Explicitly initializes instance from its mantissa value.
                    explicit
                    FixedPointDecimal(Mantissa mantissa)
                    ONIXS_BATS_PITCH_NOTHROW
                        : mantissa_(mantissa)
                    {
                    }

                    /// Initializes instance as copy of the other one.
                    FixedPointDecimal(const FixedPointDecimal& other)
                    ONIXS_BATS_PITCH_NOTHROW
                        : mantissa_(other.mantissa_)
                    {
                    }

                    /// Returns mantissa of given decimal.
                    Mantissa mantissa() const
                    ONIXS_BATS_PITCH_NOTHROW
                    {
                        return mantissa_;
                    }

                    /// Returns exponent of given decimal.
                    Exponent exponent() const
                    ONIXS_BATS_PITCH_NOTHROW
                    {
                        return Exponent();
                    }

                    /// Re-initializes instance as copy of the other one.
                    FixedPointDecimal& operator =(const FixedPointDecimal& other)
                    ONIXS_BATS_PITCH_NOTHROW
                    {
                        mantissa_ = other.mantissa_;

                        return *this;
                    }
                };

                /// Compares two fixed-point decimals. 
                template<class Mantissa, class Exponent>
                bool operator ==(
                        const FixedPointDecimal<Mantissa, Exponent>& left,
                        const FixedPointDecimal<Mantissa, Exponent>& right)
                {
                    return left.mantissa() == right.mantissa();
                }

                /// Compares two fixed-point decimals. 
                template <class Mantissa, class Exponent>
                bool operator !=(
                        const FixedPointDecimal<Mantissa, Exponent>& left,
                        const FixedPointDecimal<Mantissa, Exponent>& right)
                {
                    return left.mantissa() != right.mantissa();
                }

                /// Compares two fixed-point decimals. 
                template<class Mantissa, class Exponent>
                bool operator <(
                        const FixedPointDecimal<Mantissa, Exponent>& left,
                        const FixedPointDecimal<Mantissa, Exponent>& right)
                {
                    return left.mantissa() < right.mantissa();
                }

                /// Compares two fixed-point decimals. 
                template<class Mantissa, class Exponent>
                bool operator >(
                        const FixedPointDecimal<Mantissa, Exponent>& left,
                        const FixedPointDecimal<Mantissa, Exponent>& right)
                {
                    return left.mantissa() > right.mantissa();
                }

                /// Compares two fixed-point decimals. 
                template<class Mantissa, class Exponent>
                bool operator <=(
                        const FixedPointDecimal<Mantissa, Exponent>& left,
                        const FixedPointDecimal<Mantissa, Exponent>& right)
                {
                    return left.mantissa() <= right.mantissa();
                }

                /// Compares two fixed-point decimals. 
                template<class Mantissa, class Exponent>
                bool operator >=(
                        const FixedPointDecimal<Mantissa, Exponent>& left,
                        const FixedPointDecimal<Mantissa, Exponent>& right)
                {
                    return left.mantissa() >= right.mantissa();
                }

                /// Serializes decimal presented by 
                /// mantissa and exponent into a string. 
                ONIXS_CBOECFE_PITCH_API void decimalToStr(std::string&, Int64, Int32);

                /// Serializes fixed-point decimal into a string. 
                template <class Mantissa, class Exponent>
                inline void toStr(std::string& str, const FixedPointDecimal<Mantissa, Exponent>& number)
                {
                    decimalToStr(str, number.mantissa(), static_cast<Int32>(number.exponent().value()));
                }

                /// Serializes fixed-point decimal into a string. 
                template<class Mantissa, class Exponent>
                inline std::string toStr(const FixedPointDecimal<Mantissa, Exponent>& number)
                {
                    std::string str;

                    toStr(str, number);

                    return str;
                }

                // Serializes fixed-point decimal to stream
                template<class Mantissa, class Exponent>
                std::ostream& operator << (std::ostream& stream, const FixedPointDecimal<Mantissa, Exponent>& number)
                {
                    return stream << toStr(number);
                }
            }
        }
    }
}