Decimal, structure

Le type de valeur Decimal représente des nombres décimaux dont les valeurs varient de plus 79 228 162 514 264 337 593 543 950 335 à moins 79 228 162 514 264 337 593 543 950 335. Le type valeur Decimal convient particulièrement pour les opérations de calculs financiers nécessitant un nombre important de chiffres intégraux et fractionnaires significatifs, sans erreurs d'arrondi. Le type Decimal n'élimine pas la nécessité d'arrondir. Il réduit plutôt des erreurs en raison de l'arrondi. Par exemple, le code suivant produit un résultat de 0,9999999999999999999999999999 plutôt que 1.

decimal dividend = Decimal.One;
decimal divisor = 3;
// The following displays 0.9999999999999999999999999999 to the console
Console.WriteLine(dividend/divisor * divisor);   

Lorsque le résultat de la division et multiplication est passé à la méthode Round, le résultat ne souffre d'aucune perte de précision comme le montre le code suivant.

decimal dividend = Decimal.One;
decimal divisor = 3;
// The following displays 1.00 to the console
Console.WriteLine(Math.Round(dividend/divisor * divisor, 2));   

Un nombre décimal est une valeur à virgule flottante composée d'un signe, d'une valeur numérique dont les chiffres sont compris entre 0 et 9, et d'un facteur d'échelle qui indique la position d'une virgule décimale flottante séparant la partie entière de la partie fractionnaire de la valeur numérique.

La représentation binaire d'une valeur Decimal comporte un signe 1 bit, un nombre entier 96 bits et un facteur d'échelle servant à diviser l'entier 96 bits et à spécifier la partie correspondant à une fraction décimale. Le facteur de mise à l'échelle est implicitement le nombre 10, à une puissance allant de 0 à 28. Par conséquent, la représentation binaire d'une valeur Decimal est de la forme : ((-296 à 296) / 10(0 à 28)), où -296-1 est égal à MinValue, et 296-1 est égal à MaxValue.

Le facteur d'échelle conserve également tous les zéros de fin dans un nombre Decimal. Les zéros de fin n'affectent pas la valeur d'un nombre Decimal dans les opérations arithmétiques ou de comparaison. Toutefois, les zéros de fin peuvent être révélés par la méthode ToString si une chaîne de mise en forme appropriée est appliquée.

Considérations sur la conversion

L'exemple de code suivant illustre l'utilisation de Decimal.

	/// <summary>
	/// Keeping my fortune in Decimals to avoid the round-off errors.
	/// </summary>
	class PiggyBank {
		protected decimal MyFortune;

		public void AddPenny() {
			MyFortune = Decimal.Add(MyFortune, .01m);
		}

		public decimal Capacity {
			get {
				return Decimal.MaxValue;
			}
		}

		public decimal Dollars {
			get {
				return Decimal.Floor(MyFortune);
			}
		}

		public decimal Cents {
			get {
				return Decimal.Subtract(MyFortune, Decimal.Floor(MyFortune));
			}
		}

		public override string ToString() {
			return MyFortune.ToString("C")+" in piggy bank";
		}
	}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Tous les membres de ce type sont thread-safe. Les membres qui semblent modifier l'instance d'état retournent, en réalité, une nouvelle instance initialisée avec la nouvelle valeur. Comme avec tout autre type, la lecture et l'écriture sur une variable partagée qui contient une instance de ce type doivent être protégées par un verrou pour garantir la sécurité des threads.

Attention
L'assignation d'une instance de ce type n'est pas thread-safe sur toutes les plateformes matérielles car la représentation binaire de cette instance peut être trop grande pour être assignée dans une seule opération atomique.

Référence