Decimal.Decrement(Decimal) Operator

Definition

Decrements the Decimal operand by one.

public:
 static System::Decimal operator --(System::Decimal d);
public:
 static System::Decimal operator --(System::Decimal d) = System::Numerics::IDecrementOperators<System::Decimal>::op_Decrement;
public static decimal operator -- (decimal d);
static member op_Decrement : decimal -> decimal
Public Shared op_Decrement (d As Decimal) As Decimal

Parameters

d
Decimal

The value to decrement.

Returns

The value of d decremented by 1.

Implements

Exceptions

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:

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
let number = 1079.8m
printfn $"Original value:    {number:N}"
printfn $"Decremented value: {- -number:N}"

// 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
open System

let number = 1079.8m
printfn $"Original value:    {number:N}"
printfn $"Decremented value: {Decimal.Subtract(number, 1):N}"

// The example displays the following output:
//       Original value:    1,079.80
//       Decremented value: 1,078.80
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.Subtract(number, 1))
   End Sub
End Module
' The example displays the following output:
'       Original value:    1,079.80
'       Decremented value: 1,078.80

Applies to

See also