Decimal.Decrement(Decimal) Operator

Definition

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Source:

Decimal.cs

Decrements the Decimal operand by one.

C#

public static decimal operator --(decimal d);

Parameters

d

Decimal

The value to decrement.

Returns

Decimal

The value of d decremented by 1.

Implements

Decrement(TSelf)

Exceptions

OverflowException

The return value is less than Decimal.MinValue or greater than Decimal.MaxValue.

Remarks

The Decrement method defines the operation of the decrement operator for Decimal values. It enables code such as the following:

C#

using System;

public class Example
{
   public static void Main()
   {
      Decimal number = 1079.8m;
      Console.WriteLine("Original value:    {0:N}", number);
      Console.WriteLine("Decremented value: {0:N}", --number);
   }
}
// The example displays the following output:
//       Original value:    1,079.80
//       Decremented value: 1,078.80

Some languages (such as Visual Basic) that lack an increment operator can call the Decrement method directly, as the following example shows.

VB

Module Example
   Public Sub Main()
      Dim number As Decimal = 1079.8d
      Console.WriteLine("Original value:    {0:N}", number)
      Console.WriteLine("Decremented value: {0:N}", Decimal.op_Decrement(number))
   End Sub
End Module
' The example displays the following output:
'       Original value:    1,079.80
'       Decremented value: 1,078.80

If your language does not support custom operators, call the Subtract method instead, as the following example shows.

C#

using System;

public class Example
{
   public static void Main()
   {
      Decimal number = 1079.8m;
      Console.WriteLine("Original value:    {0:N}", number);
      Console.WriteLine("Decremented value: {0:N}", Decimal.Subtract(number, 1));
   }
}
// The example displays the following output:
//       Original value:    1,079.80
//       Decremented value: 1,078.80

Applies to

See also

• Subtract(Decimal, Decimal)