Single.CompareTo 方法

定義

命名空間:: System

組件:: netstandard.dll, System.Runtime.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

組件:: mscorlib.dll, System.Runtime.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將此實例與指定物件或另一個 Single 實例比較，並回傳一個整數，表示該實例的值是小於、等於或大於指定物件或另一個 Single 實例的值。

多載

名稱	Description
CompareTo(Object)	將此實例與指定物件比較，並回傳一個整數，表示該實例的值是小於、等於還是大於指定物件的值。
CompareTo(Single)	將此實例與指定的單精度浮點數比較，並回傳一個整數，表示該實例的值是小於、等於還是大於指定的單精度浮點數值。

CompareTo(Object)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

來源:: 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（），或 `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)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

來源:: 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

一個單精度浮點數來比較。

傳回