Module_Statistics_IComparableExtension_zh

当前位置 : 首页/统计模块/IComparableExtension

统计模块 - Statistics Module

IComparableExtension

Vorcyc.Mathematics.Statistics.IComparableExtension 是一个提供扩展方法的类，用于简化 IComparable<T> 和 IComparable 的比较操作，并支持并行计算最大值和最小值。

以下方法均位于类 ：Vorcyc.Mathematics.Statistics.IComparableExtension

---

📒目录

• 🔖 LessThan 方法
• 🔖 LessThanOrEqual 方法
• 🔖 GreaterThan 方法
• 🔖 GreaterThanOrEqual 方法
• 🔖 Equal 方法
• 🔖 NotEqual 方法
• 🔖 CompareMax 方法
• 🔖 CompareMin 方法
• 🔖 CompareMaxMin 方法
• 🔖 LocateMax 方法
• 🔖 LocateMin 方法
• 🔖 CompareMaxAsync 方法
• 🔖 LocateMaxAsync 方法
• 🔖 CompareMinAsync 方法
• 🔖 LocateMinAsync 方法

---

Vorcyc.Mathematics.Statistics.IComparableExtension 类

方法

1. LessThan 方法

• public static bool LessThan<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 确定第一个值是否小于第二个值。
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 如果第一个值小于第二个值，则返回 true；否则返回 false。

2. LessThanOrEqual 方法

• public static bool LessThanOrEqual<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 确定第一个值是否小于或等于第二个值。
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 如果第一个值小于或等于第二个值，则返回 true；否则返回 false。

3. GreaterThan 方法

• public static bool GreaterThan<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 确定第一个值是否大于第二个值。
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 如果第一个值大于第二个值，则返回 true；否则返回 false。

4. GreaterThanOrEqual 方法

• public static bool GreaterThanOrEqual<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 确定第一个值是否大于或等于第二个值。
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 如果第一个值大于或等于第二个值，则返回 true；否则返回 false。

5. Equal 方法

• public static bool Equal<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 确定第一个值是否等于第二个值。
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 如果第一个值等于第二个值，则返回 true；否则返回 false。

6. NotEqual 方法

• public static bool NotEqual<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 确定第一个值是否不等于第二个值。
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 如果第一个值不等于第二个值，则返回 true；否则返回 false。

7. CompareMax 方法

返回两个值中的最大值。

• public static T CompareMax<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 两个值中的最大值。

返回数组中的最大值。

• public static T CompareMax<T>(this T[] values) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
  • 返回值: 数组中的最大值。

返回数组指定范围内的最大值。

• public static T CompareMax<T>(this T[] values, int start, int length) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
  • 返回值: 数组指定范围内的最大值。

返回 Span 中的最大值。

• public static T CompareMax<T>(this Span<T> span) where T : IComparable, IComparable<T>
  • 参数:
    • span: 值的 Span。
  • 返回值: Span 中的最大值。

8. CompareMin 方法

返回两个值中的最小值。

• public static T CompareMin<T>(this T value1, T value2) where T : IComparable, IComparable<T>
  • 参数:
    • value1: 第一个值。
    • value2: 第二个值。
  • 返回值: 两个值中的最小值。

返回数组中的最小值。

• public static T CompareMin<T>(this T[] values) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
  • 返回值: 数组中的最小值。

返回数组指定范围内的最小值。

• public static T CompareMin<T>(this T[] values, int start, int length) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
  • 返回值: 数组指定范围内的最小值。

返回 Span 中的最小值。

• public static T CompareMin<T>(this Span<T> span) where T : IComparable, IComparable<T>
  • 参数:
    • span: 值的 Span。
  • 返回值: Span 中的最小值。

9. CompareMaxMin 方法

返回数组中的最大值和最小值。

• public static (T max, T min) CompareMaxMin<T>(this T[] values) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
  • 返回值: 包含数组中最大值和最小值的元组。

返回数组指定范围内的最大值和最小值。

• public static (T max, T min) CompareMaxMin<T>(this T[] values, int start, int length) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
  • 返回值: 包含数组指定范围内最大值和最小值的元组。

返回 Span 中的最大值和最小值。

• public static (T max, T min) CompareMaxMin<T>(this Span<T> span) where T : IComparable, IComparable<T>
  • 参数:
    • span: 值的 Span。
  • 返回值: 包含 Span 中最大值和最小值的元组。

10. LocateMax 方法

返回数组中最大元素的索引和值。

• public static (int index, T value) LocateMax<T>(T[] values) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
  • 返回值: 包含数组中最大元素的索引和值的元组。

返回数组指定范围内最大元素的索引和值。

• public static (int index, T value) LocateMax<T>(T[] values, int start, int length) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
  • 返回值: 包含数组指定范围内最大元素的索引和值的元组。

返回 Span 中最大元素的索引和值。

• public static (int index, T value) LocateMax<T>(Span<T> span) where T : IComparable, IComparable<T>
  • 参数:
    • span: 值的 Span。
  • 返回值: 包含 Span 中最大元素的索引和值的元组。

11. LocateMin 方法

返回数组中最小元素的索引和值。

• public static (int index, T value) LocateMin<T>(T[] values) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
  • 返回值: 包含数组中最小元素的索引和值的元组。

返回数组指定范围内最小元素的索引和值。

• public static (int index, T value) LocateMin<T>(T[] values, int start, int length) where T : IComparable, IComparable<T>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
  • 返回值: 包含数组指定范围内最小元素的索引和值的元组。

返回 Span 中最小元素的索引和值。

• public static (int index, T value) LocateMin<T>(Span<T> span) where T : IComparable, IComparable<T>
  • 参数:
    • span: 值的 Span。
  • 返回值: 包含 Span 中最小元素的索引和值的元组。

12. CompareMaxAsync 方法

返回并行序列中的最大值。

• public static Task<TValue> CompareMaxAsync<TValue>(this TValue[] values, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最大值。

返回并行序列指定范围内的最大值。

• public static Task<TValue> CompareMaxAsync<TValue>(this TValue[] values, int start, int length, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最大值。

13. LocateMaxAsync 方法

返回并行序列中最大元素的索引和值。

• public static Task<(int, TValue)> LocateMaxAsync<TValue>(this TValue[] values, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最大元素的索引和值。

返回并行序列指定范围内最大元素的索引和值。

• public static Task<(int, TValue)> LocateMaxAsync<TValue>(this TValue[] values, int start, int length, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最大元素的索引和值。

14. CompareMinAsync 方法

返回并行序列中的最小值。

• public static Task<TValue> CompareMinAsync<TValue>(this TValue[] values, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最小值。

返回并行序列指定范围内的最小值。

• public static Task<TValue> CompareMinAsync<TValue>(this TValue[] values, int start, int length, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最小值。

15. LocateMinAsync 方法

返回并行序列中最小元素的索引和值。

• public static Task<(int, TValue)> LocateMinAsync<TValue>(this TValue[] values, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最小元素的索引和值。

返回并行序列指定范围内最小元素的索引和值。

• public static Task<(int, TValue)> LocateMinAsync<TValue>(this TValue[] values, int start, int length, int? numberOfWorkers = null, bool useTPL = false) where TValue : IComparable, IComparable<TValue>
  • 参数:
    • values: 值的数组。
    • start: 范围的起始索引。
    • length: 范围的长度。
    • numberOfWorkers: 工作任务的数量。如果为 null，则由环境确定工作任务的数量。
    • useTPL: 如果为 true，则使用任务并行库 (TPL) 进行并行计算。
  • 返回值: 表示异步操作的任务。任务结果包含最小元素的索引和值。

代码示例

以下是一个使用 IComparableExtension 类中多个方法的示例，并在示例中加入了注释：

using System;
using System.Threading.Tasks;
using Vorcyc.Mathematics.Statistics;

public class IComparableExtensionExample
{
    public static async Task Main()
    {
        // 定义两个值
        int value1 = 5;
        int value2 = 10;

        // 比较两个值
        Console.WriteLine($"Is {value1} less than {value2}? {value1.LessThan(value2)}");
        Console.WriteLine($"Is {value1} less than or equal to {value2}? {value1.LessThanOrEqual(value2)}");
        Console.WriteLine($"Is {value1} greater than {value2}? {value1.GreaterThan(value2)}");
        Console.WriteLine($"Is {value1} greater than or equal to {value2}? {value1.GreaterThanOrEqual(value2)}");
        Console.WriteLine($"Is {value1} equal to {value2}? {value1.Equal(value2)}");
        Console.WriteLine($"Is {value1} not equal to {value2}? {value1.NotEqual(value2)}");

        // 定义一个数组
        int[] values = { 1, 2, 3, 4, 5 };

        // 获取数组中的最大值和最小值
        int max = values.CompareMax();
        int min = values.CompareMin();
        Console.WriteLine($"Max value in array: {max}");
        Console.WriteLine($"Min value in array: {min}");

        // 获取数组中最大值和最小值的索引和值
        var (maxIndex, maxValue) = values.LocateMax();
        var (minIndex, minValue) = values.LocateMin();
        Console.WriteLine($"Max value in array: {maxValue} at index {maxIndex}");
        Console.WriteLine($"Min value in array: {minValue} at index {minIndex}");

        // 并行计算数组中的最大值和最小值
        int parallelMax = await values.CompareMaxAsync();
        int parallelMin = await values.CompareMinAsync();
        Console.WriteLine($"Parallel max value in array: {parallelMax}");
        Console.WriteLine($"Parallel min value in array: {parallelMin}");

        // 并行计算数组中最大值和最小值的索引和值
        var (parallelMaxIndex, parallelMaxValue) = await values.LocateMaxAsync();
        var (parallelMinIndex, parallelMinValue) = await values.LocateMinAsync();
        Console.WriteLine($"Parallel max value in array: {parallelMaxValue} at index {parallelMaxIndex}");
        Console.WriteLine($"Parallel min value in array: {parallelMinValue} at index {parallelMinIndex}");
    }
}