/
ISubtractionOperators.cs
26 lines (24 loc) · 1.89 KB
/
ISubtractionOperators.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
namespace System.Numerics
{
/// <summary>Defines a mechanism for computing the difference of two values.</summary>
/// <typeparam name="TSelf">The type that implements this interface.</typeparam>
/// <typeparam name="TOther">The type that will be subtracted from <typeparamref name="TSelf" />.</typeparam>
/// <typeparam name="TResult">The type that contains the difference of <typeparamref name="TOther" /> subtracted from <typeparamref name="TSelf" />.</typeparam>
public interface ISubtractionOperators<TSelf, TOther, TResult>
where TSelf : ISubtractionOperators<TSelf, TOther, TResult>?
{
/// <summary>Subtracts two values to compute their difference.</summary>
/// <param name="left">The value from which <paramref name="right" /> is subtracted.</param>
/// <param name="right">The value which is subtracted from <paramref name="left" />.</param>
/// <returns>The difference of <paramref name="right" /> subtracted from <paramref name="left" />.</returns>
static abstract TResult operator -(TSelf left, TOther right);
/// <summary>Subtracts two values to compute their difference.</summary>
/// <param name="left">The value from which <paramref name="right" /> is subtracted.</param>
/// <param name="right">The value which is subtracted from <paramref name="left" />.</param>
/// <returns>The difference of <paramref name="right" /> subtracted from <paramref name="left" />.</returns>
/// <exception cref="OverflowException">The difference of <paramref name="right" /> subtracted from <paramref name="left" /> is not representable by <typeparamref name="TResult" />.</exception>
static virtual TResult operator checked -(TSelf left, TOther right) => left - right;
}
}