Single.CompareTo 메서드

정의

네임스페이스:: System

어셈블리:: netstandard.dll, System.Runtime.dll

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

어셈블리:: mscorlib.dll, System.Runtime.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

이 인스턴스를 지정된 개체 또는 다른 Single 인스턴스와 비교하고 이 인스턴스의 값이 지정된 개체의 값보다 작거나 같은지 또는 다른 Single 인스턴스의 값보다 큰지 여부를 나타내는 정수를 반환합니다.

오버로드

Name	Description
CompareTo(Object)	이 인스턴스를 지정된 개체와 비교하고 이 인스턴스의 값이 지정된 개체의 값보다 작거나 같은지 또는 더 큰지를 나타내는 정수를 반환합니다.
CompareTo(Single)	이 인스턴스를 지정된 단정밀도 부동 소수점 숫자와 비교하고 이 인스턴스의 값이 지정된 단정밀도 부동 소수점 숫자의 값보다 작거나 같은지 또는 더 큰지를 나타내는 정수를 반환합니다.

CompareTo(Object)

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

이 인스턴스를 지정된 개체와 비교하고 이 인스턴스의 값이 지정된 개체의 값보다 작거나 같은지 또는 더 큰지를 나타내는 정수를 반환합니다.

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

매개 변수

value: Object

비교할 개체 또는 null.

반품

Int32

이 인스턴스 및 .의 상대 값을 나타내는 부호 있는 숫자입니다 value.

반환 값	설명
0보다 작음	이 인스턴스가 보다 `value`작거나 이 인스턴스가 숫자(NaN)가 아니고 `value` 숫자입니다.
0	이 인스턴스가 같 `value`거나, 이 인스턴스와 값이 모두 숫자(NaN), PositiveInfinity또는 NegativeInfinity.
0보다 큼	이 인스턴스는 숫자보다 `value`크거나 이 인스턴스는 숫자()가 아니`value`고 NaN OR `value` 입니다`null`.

구현

CompareTo(Object)

예외

ArgumentException

value 가 아닙니다 Single.

예제

다음 코드 예제에서는 메서드를 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

설명

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

비록 값이 NaN인 개체가 값이 NaN인 다른 개체와 같지 않으며 심지어 자기 자신과도 같지 않더라도, IComparable<T> 인터페이스는 A.CompareTo(A)이 0을 반환해야 한다고 요구합니다.

CompareTo(System.Object)은 특정 개체와 현재 개체를 비교하는 메서드입니다.

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

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

이 메서드는 IComparable 인터페이스를 지원하도록 구현됩니다.

CompareTo(System.Single)

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

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

확대 변환

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

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

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

비교의 정밀도

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

추가 정보

Equals(Object)

적용 대상

CompareTo(Single)

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

Source:: Single.cs

이 인스턴스를 지정된 단정밀도 부동 소수점 숫자와 비교하고 이 인스턴스의 값이 지정된 단정밀도 부동 소수점 숫자의 값보다 작거나 같은지 또는 더 큰지를 나타내는 정수를 반환합니다.

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

매개 변수

value: Single

비교할 단정밀도 부동 소수점 숫자입니다.

반품