统计模块 - 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}");
    }
}

Module_Statistics_IComparableExtension_zh - vorcyc/Vorcyc.Mathematics GitHub Wiki

统计模块 - Statistics Module

IComparableExtension

Vorcyc.Mathematics.Statistics.IComparableExtension 类

方法

1. LessThan 方法

2. LessThanOrEqual 方法

3. GreaterThan 方法

4. GreaterThanOrEqual 方法

5. Equal 方法

6. NotEqual 方法

7. CompareMax 方法

8. CompareMin 方法

9. CompareMaxMin 方法

10. LocateMax 方法

11. LocateMin 方法

12. CompareMaxAsync 方法

13. LocateMaxAsync 方法

14. CompareMinAsync 方法

15. LocateMinAsync 方法

代码示例

⚠️ GitHub.com Fallback ⚠️

Module_Statistics_IComparableExtension_zh - vorcyc/Vorcyc.Mathematics GitHub Wiki

统计模块 - Statistics Module

IComparableExtension

Vorcyc.Mathematics.Statistics.IComparableExtension 类

方法

1. LessThan 方法

2. LessThanOrEqual 方法

3. GreaterThan 方法

4. GreaterThanOrEqual 方法

5. Equal 方法

6. NotEqual 方法

7. CompareMax 方法

8. CompareMin 方法

9. CompareMaxMin 方法

10. LocateMax 方法

11. LocateMin 方法

12. CompareMaxAsync 方法

13. LocateMaxAsync 方法

14. CompareMinAsync 方法

15. LocateMinAsync 方法

代码示例

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️