Decimal.Decrement(Decimal) Operator

Reference

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Decimal.cs

Source:: Decimal.cs

Source:: Decimal.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

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:

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

Jaa