Int32.CompareTo 메서드

정의

이 인스턴스를 지정된 개체나 Int32와 비교하여 상대 값의 표시를 반환합니다.Compares this instance to a specified object or Int32 and returns an indication of their relative values.

오버로드

CompareTo(Int32)

이 인스턴스를 지정된 32비트 부호 있는 정수와 비교하여 상대 값의 표시를 반환합니다.Compares this instance to a specified 32-bit signed integer and returns an indication of their relative values.

CompareTo(Object)

이 인스턴스를 지정된 개체와 비교하여 상대 값의 표시를 반환합니다.Compares this instance to a specified object and returns an indication of their relative values.

CompareTo(Int32)

이 인스턴스를 지정된 32비트 부호 있는 정수와 비교하여 상대 값의 표시를 반환합니다.Compares this instance to a specified 32-bit signed integer and returns an indication of their relative values.

public:
 virtual int CompareTo(int value);
public int CompareTo (int value);
abstract member CompareTo : int -> int
override this.CompareTo : int -> int
Public Function CompareTo (value As Integer) As Integer

매개 변수

value
Int32

비교할 정수입니다.An integer to compare.

반환

이 인스턴스와 value의 상대 값을 나타내는 부호 있는 숫자입니다.A signed number indicating the relative values of this instance and value.

반환 값Return Value 설명Description
0보다 작음Less than zero 이 인스턴스는 value보다 작습니다.This instance is less than value.
0Zero 이 인스턴스는 value와 같습니다.This instance is equal to value.
0보다 큼Greater than zero 이 인스턴스는 value보다 큽니다.This instance is greater than value.

구현

예제

다음 예제는 Int32.CompareTo(Int32) 메서드.The following example demonstrates the Int32.CompareTo(Int32) method. 네 가지 비교 메서드에 의해 반환 되는 값을 표시 하는 것 외에도 사용자 지정 멤버에 반환 값은 변환 Comparison 열거형 값도 표시 됩니다.In addition to displaying the value returned by the method for four different comparisons, it converts the return value to a member of the custom Comparison enumeration, whose value it also displays.

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).
Public Enum Comparison As Integer
   LessThan = -1
   Equal = 0
   GreaterThan = 1
End Enum

Module ValueComparison
   Public Sub Main()
      Dim mainValue As Integer = 16325
      Dim zeroValue As Integer = 0
      Dim negativeValue As Integer = -1934
      Dim positiveValue As Integer = 903624
      Dim sameValue As Integer = 16325
      
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, zeroValue, _
                        mainValue.CompareTo(zeroValue), _
                        CType(mainValue.CompareTo(zeroValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, sameValue, _
                        mainValue.CompareTo(sameValue), _
                        CType(mainValue.CompareTo(sameValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, negativeValue, _
                        mainValue.CompareTo(negativeValue), _
                        CType(mainValue.CompareTo(negativeValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, positiveValue, _
                        mainValue.CompareTo(positiveValue), _
                        CType(mainValue.CompareTo(positiveValue), Comparison))
   End Sub
End Module
' 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).

설명

이 메서드를 구현 하는 System.IComparable<T> 인터페이스 및 수행 보다 조금 더 나은 Int32.CompareTo 메서드 변환할 필요가 없기 때문에 value 개체에 대 한 매개 변수.This method implements the System.IComparable<T> interface and performs slightly better than the Int32.CompareTo method because it does not have to convert the value parameter to an object.

프로그래밍 언어에 따라 코딩할 수 있습니다는 CompareTo 메서드 매개 변수 형식은 비트 수가 적은 보다 인스턴스 형식입니다.Depending on your programming language, it might be possible to code a CompareTo method where the parameter type has fewer bits (is narrower) than the instance type. 일부 프로그래밍 언어 매개 변수를 나타내는 형식으로 비트 수 인스턴스로 암시적 확대 변환을 수행 하기 때문에 이것이 가능 합니다.This is possible because some programming languages perform an implicit widening conversion that represents the parameter as a type with as many bits as the instance.

예를 들어, 인스턴스 유형이 Int32 매개 변수 형식이 고 Byte입니다.For example, suppose the instance type is Int32 and the parameter type is Byte. Microsoft C# 컴파일러는 매개 변수의 값을 표시 하는 명령을 생성를 Int32, 다음 생성을 Int32.CompareTo 의 값을 비교 하는 메서드는 Int32 인스턴스 및 Int32 매개 변수 표시 합니다.The Microsoft C# compiler generates instructions to represent the value of the parameter as an Int32, then generates a Int32.CompareTo method that compares the values of the Int32 instance and the Int32 parameter representation.

해당 컴파일러에서 숫자 형식에 암시적 확대 변환은 수행 여부를 확인 하려면 프로그래밍 언어의 설명서를 참조 하세요.Consult your programming language's documentation to determine whether its compiler performs implicit widening conversions on numeric types.

추가 정보

CompareTo(Object)

이 인스턴스를 지정된 개체와 비교하여 상대 값의 표시를 반환합니다.Compares this instance to a specified object and returns an indication of their relative values.

public:
 virtual int CompareTo(System::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입니다.An object to compare, or null.

반환

이 인스턴스와 value의 상대 값을 나타내는 부호 있는 숫자입니다.A signed number indicating the relative values of this instance and value.

반환 값Return Value 설명Description
0보다 작음Less than zero 이 인스턴스는 value보다 작습니다.This instance is less than value.
0Zero 이 인스턴스는 value와 같습니다.This instance is equal to value.
0보다 큼Greater than zero 이 인스턴스는 value보다 큽니다.This instance is greater than value. 또는-or- valuenull입니다.value is null.

구현

예외

valueInt32이 아닌 경우value is not an Int32.

설명

인스턴스에도 Int32, 해당 값에 관계 없이 보다 큰 것으로 간주 됩니다 null합니다.Any instance of Int32, regardless of its value, is considered greater than null.

value 여야 null 인스턴스나 Int32고, 그렇지 않으면 예외가 throw 됩니다.value must be null or an instance of Int32; otherwise, an exception is thrown.

추가 정보

적용 대상