Click here to Skip to main content
Click here to Skip to main content

A Decimal Class Implementation

, 16 Feb 2003
Rate this:
Please Sign up or sign in to vote.
Use this class when high precision is required in basic numerical operations.

Introduction

In my last article[^], I eluded to the fact that there was another bug hiding in my code. Well, here it is! I guess it isn't precisely a bug, except under certain conditions, such as working with currency, in which precision is required.

Math Precision

One of the problems in the financial world is dealing with numeric precision. The double data type doesn't quite cut it, as we shall see. This presents a problem in C++ which has no decimal data type as found in C#. For example, the following C# code results in a "true" evaluation of n==201:

decimal n=.3M;
n-=.099M;
n*=1000M;
if (n==201) ...   // TRUE!

whereas using the double type in C++ does not:

double n=.3;
n-=.099;
n*=1000;
if (n==201) ...   // FALSE!

This is an important issue when dealing with financial math.

The Decimal Class

To solve this problem, I created a Decimal class. Now, I looked high and low on Code Project and Google searches for something like this, and I didn't find anything, so if I missed a contribution by another person regarding this issue, then I apologize in advance.

class Decimal
{
    public:

        static void Initialize(int precision);

        Decimal(void);
        Decimal(AutoString num);
        Decimal(const Decimal& d);
        Decimal(const __int64 n);
        Decimal(int intPart, int fractPart);

        virtual ~Decimal(void);

        Decimal operator+(const Decimal&);
        Decimal operator-(const Decimal&);
        Decimal operator*(const Decimal&);
        Decimal operator/(const Decimal&);

        Decimal operator +=(const Decimal&);
        Decimal operator -=(const Decimal&);
        Decimal operator *=(const Decimal&);
        Decimal operator /=(const Decimal&);

        bool operator==(const Decimal&) const;
        bool operator!=(const Decimal&) const;
        bool operator<(const Decimal&) const;
        bool operator<=(const Decimal&) const;
        bool operator>(const Decimal&) const;
        bool operator>=(const Decimal&) const;

        CString ToString(void) const;
        double ToDouble(void) const;

    protected:

        __int64 n;

        static int precision;
        static __int64 q;
        static char* pad;
};

This is a pretty basic implementation. A static Initialize method is used to set up the desired precision of the class, for all instances of Decimal. Internally, a few helper variables are initialized, which are used elsewhere for string to Decimal conversions and the multiplication and division operators:

void Decimal::Initialize(int prec)
{
    precision=prec;
    // create an array of 0's for padding
    pad=new char[precision+1];
    memset(pad, '0', precision);
    pad[precision]='\0';
    // get fractional precision
    q=(__int64)pow(10.0, (double)prec);        
}

A Microsoft specific 64 bit integer is used to maintain both integer and fractional components of the value, using the __int64 data type. This is a non-ANSII standard type. If you want a 96 bit integer instead, you can modify my class with PJ Naughter's 96 bit integer class found here [^].

String To __int64 Conversion

Decimal::Decimal(AutoString num)
{
    // get the integer component
    AutoString intPart=num.LeftEx('.');
    // get the fractional component
    AutoString fractPart=num.RightEx('.');

    // "multiply" the fractional part by the desired precision
    fractPart+=&pad[strlen(fractPart)];

    // create the 64bit integer as a composite of the
    // integer and fractional components.
    n=atoi(intPart);
    n*=q;
    n+=atoi(fractPart);
}

The conversion from a string to a 64 bit integer is interesting to look at as it reveals the internal workings of the class. First, the integer part and fractional parts are separated from the number. The AutoString class is a CString derived class and provides a bit nicer interface for these kind of things.

For example, given "123.456":

    AutoString intPart=num.LeftEx('.');
    AutoString fractPart=num.RightEx('.');
intPart="123"
fractPart="456"

Now let's say you've initialized the class with a precision of 4 digits past the decimal point. This creates a pad string of "0000" in the initialization function, which is used to determine how many zeros to append to the fractional string. In code:

    fractPart+=&pad[strlen(fractPart)];

fractPart is appended with a single "0" and becomes "4560".

Finally, the two components, the integer and fractional components, are combined by shifting (base 10) the integer component left by the fractional precision and adding the fractional component:

    n=atoi(intPart);
    n*=q;
    n+=atoi(fractPart);

The result is a single integer which maintains both integer and fractional components. Because all Decimal "numbers" are normalized in this way, the four basic operations (+, -, *, /) are trivial to implement.

__int64 To String Conversion

CString Decimal::ToString(void) const
{
    char s[64];
    __int64 n2=n/q;
    int fract=(int)(n-n2*q);
    sprintf(s, "%d.%0*d", (int)n2, precision, fract);
    return s;
}

Again, this code reveals the internal workings of the Decimal class. The 64 bit value is shifted right (base 10) by the precision and the integer component is extracted:

    __int64 n2=n/q;

The fractional component is extracted by shifting left the integer component and subtracting from the original value:

    int fract=(int)(n-n2*q);

And finally the string is constructed. Note the use of the * directive which tells the printf routine to determine the precision of the integer from the variable list:

    sprintf(s, "%d.%0*d", (int)n2, precision, fract);

Usage

Decimal::Initialize(4);
double n=.3;
n-=.099;
n*=1000;

printf("n=%.04lf  (int)n=%d\r\n", n, (int)n);
printf("n == 201 ? %s\r\n", n==201 ? "yes" : "no");
printf("n >= 201 ? %s\r\n", n>=201 ? "yes" : "no");

Decimal dec(".3");
dec-=Decimal(".099");
dec*=Decimal("1000");

printf("dec=%s\r\n", dec.ToString());
printf("dec == 201 ? %s\r\n", dec==Decimal("201") ? "yes" : "no");
printf("dec >= 201 ? %s\r\n", dec>=Decimal("201") ? "yes" : "no");

The above is an example usage and produces the following output:

Because the __int64 type is composed from two int types (and decomposed into int types when converted back to a string), it is limited in range to the same values as a signed four byte number, +/- 2^31, or +/-2,147,483,648.

Also, this code is not "internationalized".

References:

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Marc Clifton

United States United States
Marc is the creator of two open source projects, MyXaml, a declarative (XML) instantiation engine and the Advanced Unit Testing framework, and Interacx, a commercial n-tier RAD application suite.  Visit his website, www.marcclifton.com, where you will find many of his articles and his blog.
 
Marc lives in Philmont, NY.

Comments and Discussions

 
Generalcompare floats Pinmemberjswoofer13-Oct-06 4:18 
QuestionWhy do we need decimal? PinmemberAndrew Phillips8-Dec-04 16:14 
AnswerRe: Why do we need decimal? PinprotectorMarc Clifton8-Dec-04 16:56 
GeneralRe: Why do we need decimal? PinmemberAndrew Phillips13-Dec-04 16:11 
GeneralImprovement Suggestion PinmemberJörgen Sigvardsson5-Dec-03 9:26 
QuestionC# ? PinmemberRichard Deeming18-Feb-03 0:02 
AnswerRe: C# ? PinmemberMarc Clifton18-Feb-03 2:48 
GeneralPrecision PinmemberTaka Muraoka17-Feb-03 13:18 
GeneralRe: Precision PinmemberMarc Clifton17-Feb-03 14:24 
GeneralInteresting PinmemberJörgen Sigvardsson17-Feb-03 12:59 
GeneralRe: Interesting PinmemberPeter Hancock17-Feb-03 13:28 
GeneralRe: Interesting PinmemberJörgen Sigvardsson17-Feb-03 14:04 
GeneralRe: Interesting PinmemberMarc Clifton17-Feb-03 14:29 
GeneralRe: Interesting PinmemberJörgen Sigvardsson17-Feb-03 14:41 
GeneralRe: Interesting PinmemberPeter Hancock17-Feb-03 15:30 
GeneralRe: Interesting PinmemberJörgen Sigvardsson17-Feb-03 23:41 
GeneralRe: Interesting PinmemberPeter Hancock18-Feb-03 0:05 
GeneralRe: Interesting PinmemberMarc Clifton19-Feb-03 7:41 
GeneralRe: Interesting PinmemberTaka Muraoka17-Feb-03 19:04 
GeneralRe: Interesting PinmemberMarc Clifton17-Feb-03 14:31 
GeneralRe: Interesting PinmemberJörgen Sigvardsson17-Feb-03 14:46 
GeneralRe: Interesting PinmemberMarc Clifton17-Feb-03 14:55 
GeneralRe: Interesting PinmemberJörgen Sigvardsson17-Feb-03 23:55 
GeneralRe: Interesting PinmemberKris Vandermotten8-Oct-03 7:11 
GeneralRe: Interesting PinmemberJörgen Sigvardsson23-Feb-03 14:21 
GeneralRe: Interesting Pinmemberbrekehan12-Nov-14 14:01 
GeneralRe: Interesting PinprotectorMarc Clifton12-Nov-14 14:15 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.1411023.1 | Last Updated 17 Feb 2003
Article Copyright 2003 by Marc Clifton
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid