Decimal.Decrement Operator (Decimal)

 

Decrements the Decimal operand by one.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static decimal operator --(
	decimal d
)

Parameters

d
Type: System.Decimal

The value to decrement.

Return Value

Type: System.Decimal

The value of d decremented by 1.

Exception Condition
OverflowException

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

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

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.

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.

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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: