|
|
| System.Decimal Structure |
|
| |
| Description | |
|
The Decimal structure is explicitly designed to hold very large numbers with a large number of significant digits, as required by financial applications - no errors can be created by rounding.
Internally, the number is held in 3 parts :
| Sign | + or - |
| Mantissa | A 96 bit number, holding the significant digits |
| Exponent | 0 to 28 decimal places |
The range of numbers supported is given in the MinValue and MaxValue fields below.
The Array of Int32 constructor provides the decimal value in 4 Int32 values :
| Array[0] | Low order 32 bits of the 96 bit mantissa |
| Array[1] | Mid order 32 bits of the 96 bit mantissa |
| Array[2] | High order 32 bits of the 96 bit mantissa |
| Array[3] | Bits 16-23 contain the exponent, bit 31 the sign |
Likewise, the final constructor allows a piecemeal build of the decimal value. |
|
| Syntax | | | | Constructor Create ( | Value : Int16
; ); | | Constructor Create ( | Value : Int32
; ); | | Constructor Create ( | Value : UInt16
; ); | | Constructor Create ( | Value : UInt32
; ); | | Constructor Create ( | Value : Single
; ); | | Constructor Create ( | Value : Double
; ); | | Constructor Create ( | Values : Array of Int32
; ); | | Constructor Create ( | Low : Int32; Mid : Int32; High : Int32; IsNegative : Boolean; Exponent : Byte ); |
| | Methods | | | | Add | Adds two Decimal values together | | Compare | Compares one Decimal value with another | | CompareTo | Compares the current Decimal value to another | | Divide | Divides one Decimal value by another | | Equals | Determines if the current Decimal equals another | | Floor | Finds the lowest relative integer value nearest to the specified decimal | | GetBits | Converts a Decimal number value into an array of Integers | | Multiply | Multiplies one Decimal value by another | | Negate | Returns the supplied decimal value negated | | Parse | Converts a string representation of a Decimal into a Decimal value | | Remainder | Divides one Decimal value by another and returns the remainder | | Round | Rounds a Decimal number to the nearest value using Bankers rules | | Subtract | Subtracts one Decimal value from another | | Truncate | Drops the fractional part of a decimal number |
|
|
| | Fields | | | | MinValue | | Decimal | | -79,228,162,514,264,337,593,543,950,335
| | MaxValue | | Decimal | | 79,228,162,514,264,337,593,543,950,335
| | Zero | | Decimal | | 0
| | MinusOne | | Decimal | | -1
| | One | | Decimal | | 1 |
| | Operators | | | | + | Addition
| | - | Subtraction
| | * | Multiplication
| | / | Division
| | % | Modulus - the remainder from a divide
| | < | Less than
| | <= | Less than or equal
| | = | Equality
| | >= | Greater than or equal
| | > | Greater than |
|
Microsoft MSDN links
| |
|
|
|
|
|
| |
|
|
|