Single.CompareTo 方法

定义

命名空间:: System

程序集:: netstandard.dll, System.Runtime.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

程序集:: mscorlib.dll, System.Runtime.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将此实例与指定对象或另一 Single 个实例进行比较，并返回一个整数，该值指示此实例的值是小于、等于还是大于指定对象或其他 Single 实例的值。

重载

名称	说明
CompareTo(Object)	将此实例与指定的对象进行比较，并返回一个整数，该整数指示此实例的值是小于、等于还是大于指定对象的值。
CompareTo(Single)	将此实例与指定的单精度浮点数进行比较，并返回一个整数，该值指示此实例的值是小于、等于还是大于指定的单精度浮点数的值。

CompareTo(Object)

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

将此实例与指定的对象进行比较，并返回一个整数，该整数指示此实例的值是小于、等于还是大于指定对象的值。

public:
 virtual int CompareTo(System::Object ^ value);

public int CompareTo(object? value);

public int CompareTo(object value);

abstract member CompareTo : obj -> int
override this.CompareTo : obj -> int

Public Function CompareTo (value As Object) As Integer

参数

value: Object

要比较的对象，或 null。

Int32

一个有符号数字，指示此实例的相对值和 value。

返回值	说明
小于零	此实例小于 `value`，或者此实例不是数字（NaN）且 `value` 为数字。
零	此实例等于 `value`，或者此实例和值都不是数字（NaN）， PositiveInfinity或 NegativeInfinity。
大于零	此实例大于 `value`，或者此实例是一个数字， `value` 而不是一个数字（NaN），OR `value` 为 `null`。

实现

CompareTo(Object)

例外

ArgumentException

value不是 .Single

示例

下面的代码示例演示了该方法 CompareTo 。

obj1 = (Single)450;

if (a.CompareTo(obj1) < 0)
{
    Console.WriteLine("{0} is less than {1}.", a.ToString(), obj1.ToString());
}

if (a.CompareTo(obj1) > 0)
{
    Console.WriteLine("{0} is greater than {1}.", a.ToString(), obj1.ToString());
}

if (a.CompareTo(obj1) == 0)
{
    Console.WriteLine("{0} equals {1}.", a.ToString(), obj1.ToString());
}

let obj1 = single 450

if a.CompareTo obj1 < 0 then
    printfn $"{a} is less than {obj1}."

if a.CompareTo obj1 > 0 then
    printfn $"{a} is greater than {obj1}."

if a.CompareTo obj1 = 0 then
    printfn $"{a} equals {obj1}."

Obj1 = CType(450, Single)

If A.CompareTo(Obj1) < 0 Then
    Console.WriteLine(A.ToString() + " is less than " + Obj1.ToString() + ".")
End If

If (A.CompareTo(Obj1) > 0) Then
    Console.WriteLine(A.ToString() + " is greater than " + Obj1.ToString() + ".")
End If

If (A.CompareTo(Obj1) = 0) Then
    Console.WriteLine(A.ToString() + " equals " + Obj1.ToString() + ".")
End If

注解

值必须相同，才能被视为相等。特别是当浮点值依赖于多个数学运算时，它们通常会失去精度，并且它们的值几乎完全相同，但最小有效位数除外。因此，该方法的 CompareTo 返回值有时可能令人惊讶。例如，将一个特定值相乘后再除以相同的值应该得到原始值，但在以下示例中，计算结果大于原始值。使用“R” 标准数字格式字符串显示这两个值的所有有效数字表示计算值与其最小有效位数中的原始值不同。有关处理此类比较的信息，请参阅方法的 Equals(Single) “备注”部分。

虽然值为 NaN 的对象不被视为与另一对象（即使是它自身）的值 NaN 相等，但 IComparable<T> 接口要求 A.CompareTo(A) 返回零。

CompareTo（System.Object）

参数 value 必须是 null 或实例 Single;否则，将引发异常。无论其值如何，任何实例 Single都被视为大于 null。

using System;

public class Example
{
   public static void Main()
   {
       float value1 = 16.5457f;
       float operand = 3.8899982f;
       object value2 = value1 * operand / operand;
       Console.WriteLine($"Comparing {value1} and {value2}: {value1.CompareTo(value2)}");
       Console.WriteLine();
       Console.WriteLine($"Comparing {value1:R} and {value2:R}: {value1.CompareTo(value2)}");
   }
}
// The example displays the following output:
//       Comparing 16.5457 and 16.5457: -1
//       
//       Comparing 16.5457 and 16.545702: -1

let value1 = 16.5457f
let operand = 3.8899982f
let value2 = box (value1 * operand / operand)
printfn $"Comparing {value1} and {value2}: {value1.CompareTo value2}\n"
printfn $"Comparing {value1:R} and {value2:R}: {value1.CompareTo value2}"
// The example displays the following output:
//       Comparing 16.5457 and 16.5457: -1
//       
//       Comparing 16.5457 and 16.545702: -1

Module Example2
    Public Sub Main()
        Dim value1 As Single = 16.5457
        Dim value2 As Object = value1 * CSng(3.8899982) / CSng(3.8899982)
        Console.WriteLine("Comparing {0} and {1}: {2}",
                          value1, value2, value1.CompareTo(value2))
        Console.WriteLine()
        Console.WriteLine("Comparing {0:R} and {1:R}: {2}",
                          value1, value2, value1.CompareTo(value2))
    End Sub
End Module
' The example displays the following output:
'       Comparing 16.5457 and 16.5457: -1
'       
'       Comparing 16.5457 and 16.545702: -1

此方法实现以支持 IComparable 接口。

CompareTo（System.Single）

此方法实现 System.IComparable<T> 接口并略高于 Single.CompareTo(Object) 重载，因为它不必将 value 参数转换为对象。

using System;

public class Example2
{
   public static void Main()
   {
       float value1 = 16.5457f;
       float operand = 3.8899982f;
       float value2 = value1 * operand / operand;
       Console.WriteLine($"Comparing {value1} and {value2}: {value1.CompareTo(value2)}");
       Console.WriteLine();
       Console.WriteLine($"Comparing {value1:R} and {value2:R}: {value1.CompareTo(value2)}");
   }
}
// The example displays the following output:
//       Comparing 16.5457 and 16.5457: -1
//       
//       Comparing 16.5457 and 16.545702: -1

let value1 = 16.5457f
let operand = 3.8899982f
let value2 = value1 * operand / operand
printfn $"Comparing {value1} and {value2}: {value1.CompareTo value2}\n"
printfn $"Comparing {value1:R} and {value2:R}: {value1.CompareTo value2}"
// The example displays the following output:
//       Comparing 16.5457 and 16.5457: -1
//       
//       Comparing 16.5457 and 16.545702: -1

Module Example
   Public Sub Main()
       Dim value1 As Single = 16.5457
       Dim value2 As Single = value1 * CSng(3.8899982) / CSng(3.8899982)
       Console.WriteLine("Comparing {0} and {1}: {2}",
                         value1, value2, value1.CompareTo(value2))
       Console.WriteLine()
       Console.WriteLine("Comparing {0:R} and {1:R}: {2}",
                         value1, value2, value1.CompareTo(value2))
   End Sub
End Module
' The example displays the following output:
'       Comparing 16.5457 and 16.5457: -1
'       
'       Comparing 16.5457 and 16.545702: -1

扩大转换

根据编程语言的不同，可能编码一个CompareTo方法，其中参数类型的比特数少于实例类型（即较窄）。这是可能的，因为一些编程语言执行隐式扩大转换，该转换将参数表示为一个类型，其位数与实例数相同。

例如，假设实例类型为 Single ，参数类型为 Int32. Microsoft C# 编译器生成将参数值表示为 Single 对象的指令，然后生成一个 Single.CompareTo(Single) 方法，该方法比较实例的值和参数的扩大表示形式。

请参阅编程语言的文档，以确定其编译器是否执行数字类型的隐式扩展转换。有关详细信息，请参阅类型转换表主题。

比较中的精度

超出文档记录精度的浮点数的精度依赖于 .NET 的实现和版本。因此，两个特定数字的比较可能会在 .NET 的版本之间发生更改，因为数字的内部表示形式的精度可能会更改。

另请参阅

Equals(Object)

适用于

CompareTo(Single)

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

将此实例与指定的单精度浮点数进行比较，并返回一个整数，该值指示此实例的值是小于、等于还是大于指定的单精度浮点数的值。

public:
 virtual int CompareTo(float value);

public int CompareTo(float value);

abstract member CompareTo : single -> int
override this.CompareTo : single -> int

Public Function CompareTo (value As Single) As Integer

参数

value: Single

要比较的单精度浮点数。