내보내기(0) 인쇄
모두 확장

IComparable.CompareTo 메서드

현재 인스턴스를 동일한 형식의 다른 개체와 비교합니다.

네임스페이스: System
어셈블리: mscorlib(mscorlib.dll)

int CompareTo (
	Object obj
)
int CompareTo (
	Object obj
)
function CompareTo (
	obj : Object
) : int

매개 변수

obj

이 인스턴스와 비교할 개체입니다.

반환 값

비교되는 개체의 상대 순서를 나타내는 부호 있는 32비트 정수입니다. 반환 값에는 다음과 같은 의미가 있습니다.

의미

0보다 작음

이 인스턴스는 obj보다 작습니다.

0

이 인스턴스는 obj와 같습니다.

0보다 큼

이 인스턴스는 obj보다 큽니다.

예외 형식조건

ArgumentException

obj가 이 인스턴스와 같은 형식이 아닌 경우

이 메서드는 정의일 뿐이며 특정 클래스 또는 값 형식에 의해 구현되어야만 효과가 있습니다. "작음", "같음" 및 "큼"과 같은 비교의 의미는 특정 구현에 따라 달라집니다.

정의에 따르면 모든 개체는 Null 참조(Visual Basic의 경우 Nothing)보다 큰 것으로 간주되고 두 개의 null 참조는 서로 같은 것으로 간주됩니다.

매개 변수 obj는 이 인터페이스를 구현하는 클래스 또는 값 형식과 같은 형식이어야 합니다. 그렇지 않으면 ArgumentException이 throw됩니다.

구현자 참고 사항 개체 A, B 및 C에 대해 다음 조건이 충족되어야 합니다. A.CompareTo(A)는 0을 반환해야 합니다. A.CompareTo(B)가 0을 반환하면 B.CompareTo(A)는 0을 반환해야 합니다. A.CompareTo(B)가 0을 반환하고 B.CompareTo(C)가 0을 반환하면 A.CompareTo(C)는 0을 반환해야 합니다. A.CompareTo(B)가 0이 아닌 값을 반환하면 B.CompareTo(A)는 반대 부호의 값을 반환해야 합니다. A.CompareTo(B)가 0이 아닌 값 x를 반환하고 B.CompareTo(C)x와 같은 부호의 값 y를 반환하면 A.CompareTo(C)xy와 같은 부호의 값을 반환해야 합니다.

호출자 참고 사항 CompareTo 메서드를 사용하여 클래스의 인스턴스의 순서를 결정합니다.

다음 코드 예제에서는 CompareTo를 사용하여 IComparable을 구현하는 Temperature 개체와 다른 개체를 비교합니다.

public class Temperature : IComparable {
    /// <summary>
    /// IComparable.CompareTo implementation.
    /// </summary>
    public int CompareTo(object obj) {
        if(obj is Temperature) {
            Temperature temp = (Temperature) obj;

            return m_value.CompareTo(temp.m_value);
        }
        
        throw new ArgumentException("object is not a Temperature");    
    }

    // The value holder
    protected int m_value;

    public int Value {
        get {
            return m_value;
        }
        set {
            m_value = value;
        }
    }

    public int Celsius {
        get {
            return (m_value-32)/2;
        }
        set {
            m_value = value*2+32;
        }
    }
}

public class Temperature implements IComparable
{
    /// <summary>
    /// IComparable.CompareTo implementation.
    /// </summary>
    public int CompareTo(Object obj)
    {
        if (obj instanceof Temperature) {
            Temperature temp = (Temperature)obj;
            return ((Int32)mValue).CompareTo(temp.mValue);
        }
        throw new ArgumentException("object is not a Temperature");
    } //CompareTo

    // The value holder
    protected int mValue;

    /** @property
     */
    public int get_Value()
    {
        return mValue;
    }//get_Value

    /** @property
     */
    public void set_Value(int value)
    {
        mValue = value;
    }//set_Value

    /** @property
     */
    public int get_Celsius()
    {
        return (mValue - 32) / 2;
    }//get_Celsius

    /** @property 
     */
    public void set_Celsius(int value)
    {
        mValue = value * 2 + 32;
    }//set_Celsius
} //Temperature

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft