다음을 통해 공유


System.Double.CompareTo 메서드

이 문서는 이 API에 대한 참조 설명서를 보충하는 추가 설명을 제공합니다.

CompareTo(Double) 메서드

값이 동일해야 동등하다고 간주됩니다. 특히 부동 소수점 값이 여러 수학 연산에 의존하는 경우 정밀도를 상실하는 것이 일반적이며, 가장 적은 유효 자릿수를 제외하고 값이 거의 동일해야 합니다. 이 때문에 때때로 CompareTo 메서드의 반환 값은 놀라운 것처럼 보일 수 있습니다. 예를 들어, 특정 값을 곱한 다음 같은 값으로 나누기를 하면 원래 값이 됩니다. 그러나 다음 예제에서는 계산된 값이 원래 값보다 큰 것으로 나타났습니다. "R" 표준 숫자 형식 문자열 사용하여 두 값의 모든 유효 자릿수를 표시하면 계산된 값이 가장 낮은 유효 자릿수의 원래 값과 다르다는 것을 나타냅니다. 이러한 비교를 처리하는 방법에 대한 자세한 내용은 Equals(Double) 메서드의 설명 섹션을 참조하세요.

using System;

public class Example
{
    public static void Main()
    {
        double value1 = 6.185;
        double value2 = value1 * .1 / .1;
        Console.WriteLine($"Comparing {value1} and {value2}: {value1.CompareTo(value2)}{Environment.NewLine}");
        Console.WriteLine($"Comparing {value1:R} and {value2:R}: {value1.CompareTo(value2)}");
    }
}
// The example displays the following output:
//       Comparing 6.185 and 6.185: -1
//
//       Comparing 6.185 and 6.1850000000000005: -1
let value1 = 6.185
let value2 = value1 * 0.1 / 0.1
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 6.185 and 6.185: -1
//
//       Comparing 6.185 and 6.1850000000000005: -1
Module Example
   Public Sub Main()
       Dim value1 As Double = 6.185
       Dim value2 As Double = value1 * .1 / .1
       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 6.185 and 6.185: -1
'       
'       Comparing 6.185 and 6.1850000000000005: -1

이 메서드는 System.IComparable<T> 인터페이스를 구현하고 Double.CompareTo 매개 변수를 개체로 변환할 필요가 없으므로 value 메서드보다 약간 더 잘 수행됩니다.

값이 NaN인 개체는 값이 NaN인 다른 개체와 (자신과도) 같지 않지만, IComparable<T> 인터페이스는 A.CompareTo(A)이 0을 반환해야 한다고 요구합니다.

CompareTo(Object) 메서드

value 매개 변수는 null 또는 Double; 인스턴스여야 합니다. 그렇지 않으면 예외가 throw됩니다. 값에 관계없이 Double인스턴스는 null보다 큰 것으로 간주됩니다.

값이 동일해야 동등하다고 간주됩니다. 특히 부동 소수점 값이 여러 수학 연산에 의존하는 경우 정밀도를 상실하는 것이 일반적이며, 가장 적은 유효 자릿수를 제외하고 값이 거의 동일해야 합니다. 이 때문에 때때로 CompareTo 메서드의 반환 값은 놀라운 것처럼 보일 수 있습니다. 예를 들어, 특정 값을 곱한 다음 같은 값으로 나누기를 하면 원래 값이 됩니다. 그러나 다음 예제에서는 계산된 값이 원래 값보다 큰 것으로 나타났습니다. "R" 표준 숫자 형식 문자열 사용하여 두 값의 모든 유효 자릿수를 표시하면 계산된 값이 가장 낮은 유효 자릿수의 원래 값과 다르다는 것을 나타냅니다. 이러한 비교를 처리하는 방법에 대한 자세한 내용은 Equals(Double) 메서드의 설명 섹션을 참조하세요.

using System;

public class Example3
{
    public static void Main()
    {
        double value1 = 6.185;
        object value2 = value1 * .1 / .1;
        Console.WriteLine($"Comparing {value1} and {value2}: {value1.CompareTo(value2)}{Environment.NewLine}");
        Console.WriteLine($"Comparing {value1:R} and {value2:R}: {value1.CompareTo(value2)}");
    }
}
// The example displays the following output:
//       Comparing 6.185 and 6.185: -1
//
//       Comparing 6.185 and 6.1850000000000005: -1
let value1 = 6.185
let value2 = value1 * 0.1 / 0.1 |> box
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 6.185 and 6.185: -1
//
//       Comparing 6.185 and 6.1850000000000005: -1
Module Example2
   Public Sub Main()
       Dim value1 As Double = 6.185
       Dim value2 As Object = value1 * .1 / .1
       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 6.185 and 6.185: -1
'       
'       Comparing 6.185 and 6.1850000000000005: -1

이 메서드는 IComparable 인터페이스를 지원하도록 구현됩니다. 참고로, NaN는 다른 NaN와 같지 않으며, 심지어 자신과도 같지 않지만, IComparable 인터페이스는 A.CompareTo(A)이 0을 반환하도록 요구합니다.

확대 변환

프로그래밍 언어에 따라 매개 변수 형식이 인스턴스 형식보다 적은 비트(더 좁은)가 있는 CompareTo 메서드를 코딩할 수 있습니다. 일부 프로그래밍 언어는 인스턴스만큼 많은 비트가 있는 형식으로 매개 변수를 나타내는 암시적 확대 변환을 수행하기 때문에 가능합니다.

예를 들어 인스턴스 형식이 Double 매개 변수 형식이 Int32가정해 보겠습니다. Microsoft C# 컴파일러는 매개 변수 값을 Double 개체로 나타내는 명령을 생성한 다음 인스턴스의 값과 매개 변수의 확장된 표현을 비교하는 Double.CompareTo(Double) 메서드를 생성합니다.

프로그래밍 언어 설명서를 참조하여 컴파일러가 숫자 형식의 암시적 확대 변환을 수행하는지 확인합니다. 자세한 내용은 형식 변환 테이블 항목을 참조하세요.

비교의 정밀도

문서화된 전체 자릿수를 초과하는 부동 소수점 숫자의 정밀도는 .NET의 구현 및 버전과 관련이 있습니다. 따라서 숫자의 내부 표현의 정밀도가 변경될 수 있기 때문에 .NET 버전 간에 두 개의 특정 숫자를 비교하면 결과가 달라질 수 있습니다.