Číst v angličtině

Sdílet prostřednictvím


Int32.CompareTo Metoda

Definice

Porovná tuto instanci se zadaným 32bitovým celočíselným znaménkem a vrátí indikaci jejich relativních hodnot.

Přetížení

CompareTo(Int32)

Porovná tuto instanci se zadaným 32bitovým celočíselným znaménkem a vrátí indikaci jejich relativních hodnot.

CompareTo(Object)

Porovná tuto instanci se zadaným objektem a vrací údaj o jejich relativních hodnotách.

CompareTo(Int32)

Zdroj:
Int32.cs
Zdroj:
Int32.cs
Zdroj:
Int32.cs

Porovná tuto instanci se zadaným 32bitovým celočíselným znaménkem a vrátí indikaci jejich relativních hodnot.

public int CompareTo(int value);

Parametry

value
Int32

Celé číslo, které chcete porovnat.

Návraty

Podepsané číslo označující relativní hodnoty této instance a value.

Návratová hodnota Description
Menší než nula Tato instance je menší než value.
Žádnou Tato instance se rovná hodnotě value.
Větší než nula Tato instance je větší než value.

Implementuje

Příklady

Následující příklad ukazuje metodu Int32.CompareTo(Int32) . Kromě zobrazení hodnoty vrácené metodou pro čtyři různá porovnání převede návratovou hodnotu na člena vlastního Comparison výčtu, jehož hodnotu také zobrazí.

using System;

enum Comparison {
   LessThan=-1, Equal=0, GreaterThan=1};

public class ValueComparison
{
   public static void Main()
   {
      int mainValue = 16325;
      int zeroValue = 0;
      int negativeValue = -1934;
      int positiveValue = 903624;
      int sameValue = 16325;

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, zeroValue,
                        mainValue.CompareTo(zeroValue),
                        (Comparison) mainValue.CompareTo(zeroValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, sameValue,
                        mainValue.CompareTo(sameValue),
                        (Comparison) mainValue.CompareTo(sameValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, negativeValue,
                        mainValue.CompareTo(negativeValue),
                        (Comparison) mainValue.CompareTo(negativeValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, positiveValue,
                        mainValue.CompareTo(positiveValue),
                        (Comparison) mainValue.CompareTo(positiveValue));
   }
}
// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).

Poznámky

Tato metoda implementuje System.IComparable<T> rozhraní a funguje o něco lépe než Int32.CompareTo metoda, protože nemusí převést value parametr na objekt.

V závislosti na programovacím jazyce může být možné kódovat metodu CompareTo , kde typ parametru má méně bitů (je užší) než typ instance. Je to možné, protože některé programovací jazyky provádějí implicitní rozšiřující převod, který představuje parametr jako typ s tolika bity, kolik bitů má instance.

Předpokládejme například, že typ instance je Int32 a typ parametru je Byte. Kompilátor Microsoft jazyka C# vygeneruje instrukce k reprezentaci hodnoty parametru jako Int32, a pak vygeneruje metoduInt32.CompareTo, která porovnává hodnoty Int32 instance a reprezentace parametruInt32.

V dokumentaci pro programovací jazyk zjistíte, zda jeho kompilátor provádí implicitní rozšiřující převody u číselných typů.

Viz také

Platí pro

.NET 10 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

CompareTo(Object)

Zdroj:
Int32.cs
Zdroj:
Int32.cs
Zdroj:
Int32.cs

Porovná tuto instanci se zadaným objektem a vrací údaj o jejich relativních hodnotách.

public int CompareTo(object? value);
public int CompareTo(object value);

Parametry

value
Object

Objekt, který chcete porovnat, nebo null.

Návraty

Podepsané číslo označující relativní hodnoty této instance a value.

Návratová hodnota Description
Menší než nula Tato instance je menší než value.
Žádnou Tato instance se rovná hodnotě value.
Větší než nula Tato instance je větší než value, nebo value je null.

Implementuje

Výjimky

valuenení .Int32

Poznámky

Jakákoli instance objektu Int32bez ohledu na jeho hodnotu je považována za větší než null.

value musí být null nebo instance ; Int32jinak dojde k výjimce.

Viz také

Platí pro

.NET 10 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1