Single.CompareTo Yöntem

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Runtime.dll

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Runtime.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bu örneği belirtilen nesneyle veya başka Single bir örnekle karşılaştırır ve bu örneğin değerinin belirtilen nesnenin veya diğer Single örneğin değerinden küçük, buna eşit veya bundan büyük olup olmadığını belirten bir tamsayı döndürür.

Aşırı Yüklemeler

Name	Description
CompareTo(Object)	Bu örneği belirtilen bir nesneyle karşılaştırır ve bu örneğin değerinin belirtilen nesnenin değerinden küçük, buna eşit veya ondan büyük olup olmadığını gösteren bir tamsayı döndürür.
CompareTo(Single)	Bu örneği belirtilen tek duyarlıklı kayan noktalı sayıyla karşılaştırır ve bu örneğin değerinin belirtilen tek duyarlıklı kayan nokta sayısının değerinden küçük, buna eşit veya ondan büyük olup olmadığını gösteren bir tamsayı döndürür.

CompareTo(Object)

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Bu örneği belirtilen bir nesneyle karşılaştırır ve bu örneğin değerinin belirtilen nesnenin değerinden küçük, buna eşit veya ondan büyük olup olmadığını gösteren bir tamsayı döndürür.

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

Parametreler

value: Object

Karşılaştıracak bir nesne veya null.

Döndürülenler

Int32

Ve bu örneğin valuegöreli değerlerini gösteren imzalı bir sayı.

Dönüş Değeri	Açıklama
Sıfırdan küçük	Bu örnek değerinden `value`küçüktür veya bu örnek bir sayı (NaN) değildir ve `value` bir sayıdır.
Sıfır	Bu örnek öğesine `value`eşittir veya bu örnek ve değer sayı (NaN), PositiveInfinityveya NegativeInfinitydeğildir.
Sıfırdan büyük	Bu örnek değerinden `value`büyüktür VEYA bu örnek bir sayıdır ve `value` sayı değildir (NaN), VEYA `value` şeklindedir `null`.

Uygulamalar

CompareTo(Object)

Özel durumlar

ArgumentException

value bir Singledeğildir.

Örnekler

Aşağıdaki kod örneği yöntemini gösterir 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

Açıklamalar

Değerlerin eşit olarak kabul edilmesi için aynı olması gerekir. Özellikle kayan nokta değerleri birden çok matematik işlemine bağımlı olduğunda, duyarlıklarını kaybetmeleri ve değerlerinin en az önemli basamakları dışında neredeyse aynı olması yaygındır. Bu nedenle, CompareTo yönteminin dönüş değeri bazen şaşırtıcı görünebilir. Örneğin, belirli bir değerin çarpması ve ardından aynı değerin bölünmesi özgün değeri üretmelidir, ancak aşağıdaki örnekte hesaplanan değer özgün değerden büyük olduğu ortaya çıkar. "R" standart sayısal biçim dizesi kullanılarak iki değerin tüm önemli basamaklarının gösterilmesi, hesaplanan değerin en az önemli basamaklardaki özgün değerden farklı olduğunu gösterir. Bu tür karşılaştırmaları işleme hakkında bilgi için Equals(Single) yönteminin Açıklamalar bölümüne bakın.

Değeri NaN olan bir nesne, değeri NaN (kendisi bile) olan başka bir nesneye eşit olarak kabul edilmese de, IComparable<T> arabirimi A.CompareTo(A) sıfır döndürmesini gerektirir.

CompareTo(System.Object)

value parametresi null veya Singleörneği olmalıdır; aksi takdirde, bir özel durum oluşturulur. Singleherhangi bir örneği, değerinden bağımsız olarak nulldeğerinden büyük kabul edilir.

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

Bu yöntem IComparable arabirimini desteklemek için uygulanır.

CompareTo(System.Single)

Bu yöntem System.IComparable<T> arabirimini uygular ve Single.CompareTo(Object) parametresini bir nesneye dönüştürmesi gerekmediğinden value aşırı yüklemesinden biraz daha iyi performans gösterir.

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

Genişleyen dönüşümler

Programlama dilinize bağlı olarak, parametre türünün örnek türünden daha az bit (daha dar) olduğu bir CompareTo yöntemi kodlayabilirsiniz. Bunun nedeni, bazı programlama dillerinin parametreyi örnek kadar bit içeren bir tür olarak temsil eden örtük bir genişletme dönüştürmesi gerçekleştirmesi olabilir.

Örneğin, örnek türü Single ve parametre türü Int32 olsun. Microsoft C# derleyicisi parametrenin değerini bir Single nesnesi olarak göstermek için yönergeler oluşturur, ardından örneğin değerlerini ve parametrenin geniş gösterimini karşılaştıran bir Single.CompareTo(Single) yöntemi oluşturur.

Programlama dilinizle ilgili belgelere bakarak; derleyicisinin, sayısal türlere ilişkin örtülü genişletme dönüştürmeleri yapıp yapmadığını belirleyin. Daha fazla bilgi için Tür Dönüştürme Tabloları konusuna bakın.

Karşılaştırmalarda kesinlik

Kayan noktalı sayıların, belgelenen duyarlığı aşan duyarlığı, .NET'in uygulamasına ve sürümüne özgüdür. Sonuç olarak, sayıların iç gösteriminin duyarlığı değişebileceğinden, belirli iki sayının karşılaştırması .NET sürümleri arasında değişebilir.

Ayrıca bkz.

Equals(Object)

Şunlara uygulanır

CompareTo(Single)

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Bu örneği belirtilen tek duyarlıklı kayan noktalı sayıyla karşılaştırır ve bu örneğin değerinin belirtilen tek duyarlıklı kayan nokta sayısının değerinden küçük, buna eşit veya ondan büyük olup olmadığını gösteren bir tamsayı döndürür.

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