# Double 구조체

## 정의

배정밀도 부동 소수점 숫자를 나타냅니다.

``public value class double : IComparable, IComparable<double>, IConvertible, IEquatable<double>, IFormattable``
``public value class double : IComparable, IComparable<double>, IConvertible, IEquatable<double>, ISpanFormattable``
``public value class double : IComparable, IConvertible, IFormattable``
``public value class double : IComparable, IComparable<double>, IEquatable<double>, IFormattable``
``public struct Double : IComparable, IComparable<double>, IConvertible, IEquatable<double>, IFormattable``
``public struct Double : IComparable, IComparable<double>, IConvertible, IEquatable<double>, ISpanFormattable``
``````[System.Serializable]
public struct Double : IComparable, IConvertible, IFormattable``````
``````[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct Double : IComparable, IComparable<double>, IConvertible, IEquatable<double>, IFormattable``````
``public struct Double : IComparable, IComparable<double>, IEquatable<double>, IFormattable``
``````type double = struct
interface IConvertible
interface IFormattable``````
``````type double = struct
interface IConvertible
interface ISpanFormattable
interface IFormattable``````
``````[<System.Serializable>]
type double = struct
interface IFormattable
interface IConvertible``````
``````[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type double = struct
interface IFormattable
interface IConvertible``````
``````type double = struct
interface IFormattable``````
``````Public Structure Double
Implements IComparable, IComparable(Of Double), IConvertible, IEquatable(Of Double), IFormattable``````
``````Public Structure Double
Implements IComparable, IComparable(Of Double), IConvertible, IEquatable(Of Double), ISpanFormattable``````
``````Public Structure Double
Implements IComparable, IConvertible, IFormattable``````
``````Public Structure Double
Implements IComparable, IComparable(Of Double), IEquatable(Of Double), IFormattable``````
상속
Double
특성
구현

## 예제

다음 코드 예제에서는 의 사용을 보여 줍니다. Double

``````// The Temperature class stores the temperature as a Double
// and delegates most of the functionality to the Double
// implementation.
public ref class Temperature: public IComparable, public IFormattable
{
// IComparable.CompareTo implementation.
public:
virtual int CompareTo( Object^ obj )
{
if (obj == nullptr) return 1;

if (dynamic_cast<Temperature^>(obj) )
{
Temperature^ temp = (Temperature^)(obj);
return m_value.CompareTo( temp->m_value );
}
throw gcnew ArgumentException( "object is not a Temperature" );
}

// IFormattable.ToString implementation.
virtual String^ ToString( String^ format, IFormatProvider^ provider )
{
if ( format != nullptr )
{
if ( format->Equals( "F" ) )
{
return String::Format( "{0}'F", this->Value.ToString() );
}

if ( format->Equals( "C" ) )
{
return String::Format( "{0}'C", this->Celsius.ToString() );
}
}
return m_value.ToString( format, provider );
}

// Parses the temperature from a string in the form
// [ws][sign]digits['F|'C][ws]
static Temperature^ Parse( String^ s, NumberStyles styles, IFormatProvider^ provider )
{
Temperature^ temp = gcnew Temperature;

if ( s->TrimEnd(nullptr)->EndsWith( "'F" ) )
{
temp->Value = Double::Parse( s->Remove( s->LastIndexOf( '\'' ), 2 ), styles, provider );
}
else
if ( s->TrimEnd(nullptr)->EndsWith( "'C" ) )
{
temp->Celsius = Double::Parse( s->Remove( s->LastIndexOf( '\'' ), 2 ), styles, provider );
}
else
{
temp->Value = Double::Parse( s, styles, provider );
}
return temp;
}

protected:
double m_value;

public:
property double Value
{
double get()
{
return m_value;
}

void set( double value )
{
m_value = value;
}
}

property double Celsius
{
double get()
{
return (m_value - 32.0) / 1.8;
}

void set( double value )
{
m_value = 1.8 * value + 32.0;
}
}
};
``````
``````// The Temperature class stores the temperature as a Double
// and delegates most of the functionality to the Double
// implementation.
public class Temperature : IComparable, IFormattable
{
// IComparable.CompareTo implementation.
public int CompareTo(object obj) {
if (obj == null) return 1;

Temperature temp = obj as Temperature;
if (obj != null)
return m_value.CompareTo(temp.m_value);
else
throw new ArgumentException("object is not a Temperature");
}

// IFormattable.ToString implementation.
public string ToString(string format, IFormatProvider provider) {
if( format != null ) {
if( format.Equals("F") ) {
return String.Format("{0}'F", this.Value.ToString());
}
if( format.Equals("C") ) {
return String.Format("{0}'C", this.Celsius.ToString());
}
}

return m_value.ToString(format, provider);
}

// Parses the temperature from a string in the form
// [ws][sign]digits['F|'C][ws]
public static Temperature Parse(string s, NumberStyles styles, IFormatProvider provider) {
Temperature temp = new Temperature();

if( s.TrimEnd(null).EndsWith("'F") ) {
temp.Value = Double.Parse( s.Remove(s.LastIndexOf('\''), 2), styles, provider);
}
else if( s.TrimEnd(null).EndsWith("'C") ) {
temp.Celsius = Double.Parse( s.Remove(s.LastIndexOf('\''), 2), styles, provider);
}
else {
temp.Value = Double.Parse(s, styles, provider);
}

return temp;
}

// The value holder
protected double m_value;

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

public double Celsius {
get {
return (m_value-32.0)/1.8;
}
set {
m_value = 1.8*value+32.0;
}
}
}
``````
``````' Temperature class stores the value as Double
' and delegates most of the functionality
' to the Double implementation.
Public Class Temperature
Implements IComparable, IFormattable

Public Overloads Function CompareTo(ByVal obj As Object) As Integer _
Implements IComparable.CompareTo

If TypeOf obj Is Temperature Then
Dim temp As Temperature = CType(obj, Temperature)

Return m_value.CompareTo(temp.m_value)
End If

Throw New ArgumentException("object is not a Temperature")
End Function

Public Overloads Function ToString(ByVal format As String, ByVal provider As IFormatProvider) As String _
Implements IFormattable.ToString

If Not (format Is Nothing) Then
If format.Equals("F") Then
Return [String].Format("{0}'F", Me.Value.ToString())
End If
If format.Equals("C") Then
Return [String].Format("{0}'C", Me.Celsius.ToString())
End If
End If

Return m_value.ToString(format, provider)
End Function

' Parses the temperature from a string in form
' [ws][sign]digits['F|'C][ws]
Public Shared Function Parse(ByVal s As String, ByVal styles As NumberStyles, ByVal provider As IFormatProvider) As Temperature
Dim temp As New Temperature()

If s.TrimEnd(Nothing).EndsWith("'F") Then
temp.Value = Double.Parse(s.Remove(s.LastIndexOf("'"c), 2), styles, provider)
Else
If s.TrimEnd(Nothing).EndsWith("'C") Then
temp.Celsius = Double.Parse(s.Remove(s.LastIndexOf("'"c), 2), styles, provider)
Else
temp.Value = Double.Parse(s, styles, provider)
End If
End If
Return temp
End Function

' The value holder
Protected m_value As Double

Public Property Value() As Double
Get
Return m_value
End Get
Set(ByVal Value As Double)
m_value = Value
End Set
End Property

Public Property Celsius() As Double
Get
Return (m_value - 32) / 1.8
End Get
Set(ByVal Value As Double)
m_value = Value * 1.8 + 32
End Set
End Property
End Class
``````

## 설명

Double값 형식은 음수 1.79769313486232 e 308에서 양의 1.79769313486232 e 308 사이의 값을 포함 하는 배정밀도 64 비트 숫자를 나타내며 양수 또는 음수 0, PositiveInfinity , NegativeInfinity 및는 숫자가 아닙니다 ( NaN ). 이 값은 매우 큰 값 (예: 행성 또는 galaxies 간 거리) 또는 매우 작은 값 (예: 킬로그램의 분자 질량)을 나타내는 데 사용 됩니다. 즉, 지구에서 다른 태양으로의 거리와 같이 정확 하지 않은 경우도 있습니다. Double형식은 이진 부동 소수점 산술 연산에 대 한 IEC 60559:1989 (IEEE 754) 표준을 준수 합니다.

이 항목은 다음 섹션으로 구성되어 있습니다.

### Floating-Point 표시 및 전체 자릿수

Double데이터 형식은 다음 표에 표시 된 것 처럼 64 비트 이진 형식으로 배정밀도 부동 소수점 값을 저장 합니다.

파트 비트
Significand 또는가 나 0-51
지수 52-62
Sign (0 = 양수, 1 = 음수) 63

소수 자릿수가 소수 자릿수 값 (예: 1/3 또는)을 정확 하 게 나타낼 수 없는 것 처럼 Math.PI 이진 분수는 일부 소수 값을 나타낼 수 없습니다. 예를 들어, 숫자를 10 진수 분수로 정확히 나타내는 1/10은. 001100110011에서 이진 분수로 표시 되 고 "0011" 패턴은 무한대로 반복 됩니다. 이 경우 부동 소수점 값은 해당 값이 나타내는 숫자를 정확 하 게 표현 합니다. 원래 부동 소수점 값에 대 한 추가 수학적 연산을 수행 하면 정밀도가 떨어질 수 있습니다. 예를 들어, 0.1을 10으로 곱한 결과를 비교 하 고. 1 9 번을 추가 하는 경우 8 개 이상의 작업을 포함 했기 때문에 보다 정확한 결과를 생성 하는 것을 알 수 있습니다. 이 차이가는 Double "R" 표준 숫자 서식 문자열을 사용 하 여 두 값을 표시 하는 경우에만 표시 됩니다 .이 문자열은 필요한 경우 형식에서 지 원하는 모든 전체 자릿수의 17 자리를 표시 Double 합니다.

``````using System;

public class Example
{
public static void Main()
{
Double value = .1;
Double result1 = value * 10;
Double result2 = 0;
for (int ctr = 1; ctr <= 10; ctr++)
result2 += value;

Console.WriteLine(".1 * 10:           {0:R}", result1);
Console.WriteLine(".1 Added 10 times: {0:R}", result2);
}
}
// The example displays the following output:
//       .1 * 10:           1
//       .1 Added 10 times: 0.99999999999999989
``````
``````Module Example
Public Sub Main()
Dim value As Double = .1
Dim result1 As Double = value * 10
Dim result2 As Double
For ctr As Integer = 1 To 10
result2 += value
Next
Console.WriteLine(".1 * 10:           {0:R}", result1)
Console.WriteLine(".1 Added 10 times: {0:R}", result2)
End Sub
End Module
' The example displays the following output:
'       .1 * 10:           1
'       .1 Added 10 times: 0.99999999999999989
``````

일부 숫자는 정확히 소수 자릿수의 이진 값으로 표현할 수 없기 때문에 부동 소수점 숫자는 실수에 불과합니다.

또한 모든 부동 소수점 숫자는 제한 된 수의 유효 자릿수가 있으므로 부동 소수점 값이 실수와 얼마나 정확 하 게 근사치를 결정 합니다. Double값은 최대 15 자리의 전체 자릿수를 갖지만 최대 17 자리는 내부적으로 유지 됩니다. 즉, 일부 부동 소수점 연산에는 부동 소수점 값을 변경 하기 위한 전체 자릿수가 부족할 수 있습니다. 다음 예제에서 이에 대해 설명합니다. 매우 큰 부동 소수점 값을 정의 하 고 그에 대 한 제품 Double.Epsilon 및 quadrillion를 추가 합니다. 그러나 제품이 너무 작아서 원래 부동 소수점 값을 수정할 수 없습니다. 최소 유효 숫자는 1/1000 초 이지만 제품에서 가장 중요 한 숫자는 10-309입니다.

``````using System;

public class Example
{
public static void Main()
{
Double value = 123456789012.34567;
Double additional = Double.Epsilon * 1e15;
Console.WriteLine("{0} + {1} = {2}", value, additional,
}
}
// The example displays the following output:
//    123456789012.346 + 4.94065645841247E-309 = 123456789012.346
``````
``````Module Example
Public Sub Main()
Dim value As Double = 123456789012.34567
Dim additional As Double = Double.Epsilon * 1e15
Console.WriteLine("{0} + {1} = {2}", value, additional,
End Sub
End Module
' The example displays the following output:
'   123456789012.346 + 4.94065645841247E-309 = 123456789012.346
``````

부동 소수점 숫자의 제한 된 전체 자릿수에는 다음과 같은 여러 가지 결과가 있습니다.

• 특정 전체 자릿수에서 동일하게 나타나는 두 개의 부동 소수점 숫자는 최소 유효 자릿수가 다르므로 동일하게 비교되지 않을 수 있습니다. 다음 예에서는 일련의 숫자를 함께 추가 하 고 합계를 예상 합계와 비교 합니다. 두 값이 동일 하 게 표시 되기는 하지만 메서드를 호출 하면 해당 값 `Equals` 이 표시 되지 않습니다.

``````using System;

public class Example
{
public static void Main()
{
Double[] values = { 10.0, 2.88, 2.88, 2.88, 9.0 };
Double result = 27.64;
Double total = 0;
foreach (var value in values)
total += value;

if (total.Equals(result))
Console.WriteLine("The sum of the values equals the total.");
else
Console.WriteLine("The sum of the values ({0}) does not equal the total ({1}).",
total, result);
}
}
// The example displays the following output:
//      The sum of the values (36.64) does not equal the total (36.64).
//
// If the index items in the Console.WriteLine statement are changed to {0:R},
// the example displays the following output:
//       The sum of the values (27.639999999999997) does not equal the total (27.64).
``````
``````Module Example
Public Sub Main()
Dim values() As Double = { 10.0, 2.88, 2.88, 2.88, 9.0 }
Dim result As Double = 27.64
Dim total As Double
For Each value In values
total += value
Next
If total.Equals(result) Then
Console.WriteLine("The sum of the values equals the total.")
Else
Console.WriteLine("The sum of the values ({0}) does not equal the total ({1}).",
total, result)
End If
End Sub
End Module
' The example displays the following output:
'      The sum of the values (36.64) does not equal the total (36.64).
'
' If the index items in the Console.WriteLine statement are changed to {0:R},
' the example displays the following output:
'       The sum of the values (27.639999999999997) does not equal the total (27.64).
``````

문의 형식 항목을 Console.WriteLine(String, Object, Object) 및에서로 변경 하 `{0}` `{1}` `{0:R}``{1:R}` 두 값의 유효 자릿수를 모두 표시 하는 경우 Double 더하기 연산 중에 전체 자릿수가 손실 되어 두 값이 같지 않은 것을 알 수 있습니다. 이 경우 Math.Round(Double, Int32) 비교를 수행 하기 전에 메서드를 호출 하 여 Double 값을 원하는 전체 자릿수로 반올림 하 여 문제를 해결할 수 있습니다.

• 부동 소수점 숫자를 사용 하는 수학 또는 비교 연산은 10 진수가 사용 될 경우 동일한 결과를 생성 하지 않을 수 있습니다. 이진 부동 소수점 숫자가 10 진수와 같지 않을 수 있기 때문입니다. 이전 예에서는 1과 10을 곱한 결과를 표시 하 고를 1 번 추가 하 여이를 보여 줍니다.

소수 값을 사용 하는 숫자 연산의 정확도가 중요 한 경우 형식 대신을 사용할 수 있습니다 Decimal Double . 또는 형식 범위를 벗어나는 정수 값을 사용 하는 숫자 연산의 Int64 정확도 UInt64 가 중요 한 경우 형식을 사용 BigInteger 합니다.

• 부동 소수점 숫자가 포함 된 경우 값은 라운드트립 하지 않을 수 있습니다. 연산에서 원래 부동 소수점 숫자를 다른 형식으로 변환 하 고, 역 작업을 통해 변환 된 폼을 다시 부동 소수점 숫자로 변환 하 고, 마지막 부동 소수점 숫자가 원래 부동 소수점 숫자와 같지 않은 경우 값을 라운드트립 이라고 합니다. 변환 시 하나 이상의 유효 자릿수가 손실 되거나 변경 되기 때문에 라운드트립이 실패할 수 있습니다. 다음 예제에서는 3 개의 Double 값을 문자열로 변환 하 고 파일에 저장 합니다. 그러나 출력에 표시 되는 값이 동일 하더라도 복원 된 값은 원래 값과 같지 않습니다.

``````using System;
using System.IO;

public class Example
{
public static void Main()
{
StreamWriter sw = new StreamWriter(@".\Doubles.dat");
Double[] values = { 2.2/1.01, 1.0/3, Math.PI };
for (int ctr = 0; ctr < values.Length; ctr++) {
sw.Write(values[ctr].ToString());
if (ctr != values.Length - 1)
sw.Write("|");
}
sw.Close();

Double[] restoredValues = new Double[values.Length];
string[] tempStrings = temp.Split('|');
for (int ctr = 0; ctr < tempStrings.Length; ctr++)
restoredValues[ctr] = Double.Parse(tempStrings[ctr]);

for (int ctr = 0; ctr < values.Length; ctr++)
Console.WriteLine("{0} {2} {1}", values[ctr],
restoredValues[ctr],
values[ctr].Equals(restoredValues[ctr]) ? "=" : "<>");
}
}
// The example displays the following output:
//       2.17821782178218 <> 2.17821782178218
//       0.333333333333333 <> 0.333333333333333
//       3.14159265358979 <> 3.14159265358979
``````
``````Imports System.IO

Module Example
Public Sub Main()
Dim sw As New StreamWriter(".\Doubles.dat")
Dim values() As Double = { 2.2/1.01, 1.0/3, Math.PI }
For ctr As Integer = 0 To values.Length - 1
sw.Write(values(ctr).ToString())
If ctr <> values.Length - 1 Then sw.Write("|")
Next
sw.Close()

Dim restoredValues(values.Length - 1) As Double
Dim temp As String = sr.ReadToEnd()
Dim tempStrings() As String = temp.Split("|"c)
For ctr As Integer = 0 To tempStrings.Length - 1
restoredValues(ctr) = Double.Parse(tempStrings(ctr))
Next

For ctr As Integer = 0 To values.Length - 1
Console.WriteLine("{0} {2} {1}", values(ctr),
restoredValues(ctr),
If(values(ctr).Equals(restoredValues(ctr)), "=", "<>"))
Next
End Sub
End Module
' The example displays the following output:
'       2.17821782178218 <> 2.17821782178218
'       0.333333333333333 <> 0.333333333333333
'       3.14159265358979 <> 3.14159265358979
``````

이 경우 다음 예제와 같이 "G17" 표준 숫자 서식 문자열 을 사용 하 여 값의 전체 자릿수를 유지 함으로써 값을 성공적으로 반올림할 수 있습니다 Double .

``````using System;
using System.IO;

public class Example
{
public static void Main()
{
StreamWriter sw = new StreamWriter(@".\Doubles.dat");
Double[] values = { 2.2/1.01, 1.0/3, Math.PI };
for (int ctr = 0; ctr < values.Length; ctr++)
sw.Write("{0:G17}{1}", values[ctr], ctr < values.Length - 1 ? "|" : "" );

sw.Close();

Double[] restoredValues = new Double[values.Length];
string[] tempStrings = temp.Split('|');
for (int ctr = 0; ctr < tempStrings.Length; ctr++)
restoredValues[ctr] = Double.Parse(tempStrings[ctr]);

for (int ctr = 0; ctr < values.Length; ctr++)
Console.WriteLine("{0} {2} {1}", values[ctr],
restoredValues[ctr],
values[ctr].Equals(restoredValues[ctr]) ? "=" : "<>");
}
}
// The example displays the following output:
//       2.17821782178218 = 2.17821782178218
//       0.333333333333333 = 0.333333333333333
//       3.14159265358979 = 3.14159265358979
``````
``````Imports System.IO

Module Example
Public Sub Main()
Dim sw As New StreamWriter(".\Doubles.dat")
Dim values() As Double = { 2.2/1.01, 1.0/3, Math.PI }
For ctr As Integer = 0 To values.Length - 1
sw.Write("{0:G17}{1}", values(ctr),
If(ctr < values.Length - 1, "|", ""))
Next
sw.Close()

Dim restoredValues(values.Length - 1) As Double
Dim temp As String = sr.ReadToEnd()
Dim tempStrings() As String = temp.Split("|"c)
For ctr As Integer = 0 To tempStrings.Length - 1
restoredValues(ctr) = Double.Parse(tempStrings(ctr))
Next

For ctr As Integer = 0 To values.Length - 1
Console.WriteLine("{0} {2} {1}", values(ctr),
restoredValues(ctr),
If(values(ctr).Equals(restoredValues(ctr)), "=", "<>"))
Next
End Sub
End Module
' The example displays the following output:
'       2.17821782178218 = 2.17821782178218
'       0.333333333333333 = 0.333333333333333
'       3.14159265358979 = 3.14159265358979
``````

중요

값과 함께 사용할 경우 Double 일부 경우에 "R" 형식 지정자는 원래 값을 성공적으로 라운드트립 하지 못합니다. 값이 성공적으로 라운드트립 되도록 하려면 Double "G17" 형식 지정자를 사용 합니다.

• Single 값의 전체 자릿수가 값 보다 낮습니다 Double . 큰 Single 값으로 변환 되는 값은 Double Double 전체 자릿수 차이로 인해 값과 같지 않습니다. 다음 예에서는 동일한 나누기 연산의 결과가 및 값에 할당 됩니다 Double Single . Single값이로 캐스팅 되 면 Double 두 값을 비교 하 여 두 값이 같지 않음을 나타냅니다.

``````using System;

public class Example
{
public static void Main()
{
Double value1 = 1/3.0;
Single sValue2 = 1/3.0f;
Double value2 = (Double) sValue2;
Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2,
value1.Equals(value2));
}
}
// The example displays the following output:
//        0.33333333333333331 = 0.3333333432674408: False
``````
``````Module Example
Public Sub Main()
Dim value1 As Double = 1/3
Dim sValue2 As Single = 1/3
Dim value2 As Double = CDbl(sValue2)
Console.WriteLine("{0} = {1}: {2}", value1, value2, value1.Equals(value2))
End Sub
End Module
' The example displays the following output:
'       0.33333333333333331 = 0.3333333432674408: False
``````

이 문제를 방지 하려면 데이터 형식 대신를 사용 Double Single 하거나 Round 두 값의 전체 자릿수가 같도록 메서드를 사용 합니다.

또한 값을 포함 하는 산술 및 할당 연산의 결과는 Double 형식의 전체 자릿수가 손실 될 수 있으므로 플랫폼에 따라 약간 다를 수 있습니다 Double . 예를 들어 리터럴 값을 할당 한 결과는 Double 32 비트 및 64 비트 버전 .NET Framework 다를 수 있습니다. 다음 예에서는 리터럴 값-4.42330604244772 E-305 및 값이-4.42330604244772 E-305 인 변수가 변수에 할당 될 때 이러한 차이를 보여 줍니다 Double . Parse(String)이 경우 메서드의 결과는 전체 자릿수가 손실 되지 않습니다.

``````double value = -4.42330604244772E-305;

double fromLiteral = -4.42330604244772E-305;
double fromVariable = value;
double fromParse = Double.Parse("-4.42330604244772E-305");

Console.WriteLine("Double value from literal: {0,29:R}", fromLiteral);
Console.WriteLine("Double value from variable: {0,28:R}", fromVariable);
Console.WriteLine("Double value from Parse method: {0,24:R}", fromParse);
// On 32-bit versions of the .NET Framework, the output is:
//    Double value from literal:        -4.42330604244772E-305
//    Double value from variable:       -4.42330604244772E-305
//    Double value from Parse method:   -4.42330604244772E-305
//
// On other versions of the .NET Framework, the output is:
//    Double value from literal:      -4.4233060424477198E-305
//    Double value from variable:     -4.4233060424477198E-305
//    Double value from Parse method:   -4.42330604244772E-305
``````
``````Dim value As Double = -4.42330604244772E-305

Dim fromLiteral As Double = -4.42330604244772E-305
Dim fromVariable As Double = value
Dim fromParse As Double = Double.Parse("-4.42330604244772E-305")

Console.WriteLine("Double value from literal: {0,29:R}", fromLiteral)
Console.WriteLine("Double value from variable: {0,28:R}", fromVariable)
Console.WriteLine("Double value from Parse method: {0,24:R}", fromParse)
' On 32-bit versions of the .NET Framework, the output is:
'    Double value from literal:        -4.42330604244772E-305
'    Double value from variable:       -4.42330604244772E-305
'    Double value from Parse method:   -4.42330604244772E-305
'
' On other versions of the .NET Framework, the output is:
'    Double value from literal:        -4.4233060424477198E-305
'    Double value from variable:       -4.4233060424477198E-305
'    Double value from Parse method:     -4.42330604244772E-305
``````

### 같음 테스트

동일 하 게 간주 되려면 두 Double 값이 동일한 값을 나타내야 합니다. 그러나 값 사이의 전체 자릿수 차이 때문에 또는 하나 또는 두 값의 전체 자릿수 손실로 인해 동일 하 게 예상 되는 부동 소수점 값은 최소 유효 자릿수의 차이로 인해 동일 하지 않게 됩니다. 따라서 메서드를 호출 Equals 하 여 두 값이 같은지 여부를 확인 하거나 메서드를 호출 하 여 CompareTo 두 값 간의 관계를 확인 하는 Double 경우가 종종 예기치 않은 결과를 생성 합니다. 다음 예제에서는 Double 첫 번째 값의 전체 자릿수는 15이 고 두 번째 값은 17 이기 때문에 두 개의 동일한 값이 같지 않은 것으로 확인 되는 경우를 예로 들 수 있습니다.

``````using System;

public class Example
{
public static void Main()
{
double value1 = .333333333333333;
double value2 = 1.0/3;
Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2, value1.Equals(value2));
}
}
// The example displays the following output:
//        0.333333333333333 = 0.33333333333333331: False
``````
``````Module Example
Public Sub Main()
Dim value1 As Double = .333333333333333
Dim value2 As Double = 1/3
Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2, value1.Equals(value2))
End Sub
End Module
' The example displays the following output:
'       0.333333333333333 = 0.33333333333333331: False
``````

다른 코드 경로를 따르고 서로 다른 방법으로 조작 되는 계산 된 값은 서로 다르게 증명 되는 경우가 많습니다. 다음 예제에서 한 Double 값은 제곱 된 후 제곱근을 계산 하 여 원래 값을 복원 합니다. 두 번째는 Double 3.51를 곱하여 결과의 제곱근이 3.51으로 나뉘어 원래 값을 복원 합니다. 두 값이 동일한 것으로 보이지만 메서드를 호출 하면 해당 값 Equals(Double) 이 같지 않음을 나타냅니다. "R" 표준 형식 문자열을 사용 하 여 각 Double 값의 유효 자릿수를 모두 표시 하는 결과 문자열을 반환 하면 두 번째 값이 첫 번째 값 보다 .0000000000001 것을 보여 줍니다.

``````using System;

public class Example
{
public static void Main()
{
double value1 = 100.10142;
value1 = Math.Sqrt(Math.Pow(value1, 2));
double value2 = Math.Pow(value1 * 3.51, 2);
value2 = Math.Sqrt(value2) / 3.51;
Console.WriteLine("{0} = {1}: {2}\n",
value1, value2, value1.Equals(value2));
Console.WriteLine("{0:R} = {1:R}", value1, value2);
}
}
// The example displays the following output:
//    100.10142 = 100.10142: False
//
//    100.10142 = 100.10141999999999
``````
``````Module Example
Public Sub Main()
Dim value1 As Double = 100.10142
value1 = Math.Sqrt(Math.Pow(value1, 2))
Dim value2 As Double = Math.Pow(value1 * 3.51, 2)
value2 = Math.Sqrt(value2) / 3.51
Console.WriteLine("{0} = {1}: {2}",
value1, value2, value1.Equals(value2))
Console.WriteLine()
Console.WriteLine("{0:R} = {1:R}", value1, value2)
End Sub
End Module
' The example displays the following output:
'    100.10142 = 100.10142: False
'
'    100.10142 = 100.10141999999999
``````

정밀도 손실이 비교의 결과에 영향을 줄 가능성이 있는 경우 또는 메서드를 호출 하는 다음과 같은 대체 방법을 채택할 수 있습니다 Equals CompareTo .

• 메서드를 호출 Math.Round 하 여 두 값의 전체 자릿수가 동일한 지 확인 합니다. 다음 예에서는 두 개의 소수 값이 동일한 것으로이 방법을 사용 하도록 이전 예제를 수정 합니다.

``````using System;

public class Example
{
public static void Main()
{
double value1 = .333333333333333;
double value2 = 1.0/3;
int precision = 7;
value1 = Math.Round(value1, precision);
value2 = Math.Round(value2, precision);
Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2, value1.Equals(value2));
}
}
// The example displays the following output:
//        0.3333333 = 0.3333333: True
``````
``````Module Example
Public Sub Main()
Dim value1 As Double = .333333333333333
Dim value2 As Double = 1/3
Dim precision As Integer = 7
value1 = Math.Round(value1, precision)
value2 = Math.Round(value2, precision)
Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2, value1.Equals(value2))
End Sub
End Module
' The example displays the following output:
'       0.3333333 = 0.3333333: True
``````

정밀도의 문제는 중간점 값의 반올림에도 적용 됩니다. 자세한 내용은 Math.Round(Double, Int32, MidpointRounding) 메서드를 참조하세요.

• 같음 보다는 근사값이 같은지 테스트 합니다. 이렇게 하려면 두 값이 서로 다를 수 있지만 동일 하거나 더 작은 값이 더 큰 값에서 분기할 수 있는 상대 크기를 정의 해야 합니다.

경고

Double.Epsilon 는 같음 여부를 테스트할 때 두 값 사이의 거리에 대 한 절대 측정값으로 사용 되는 경우가 있습니다 Double . 그러나 Double.Epsilon 는 값이 0 인을 더하거나 뺄 수 있는 최소값을 측정 Double 합니다. 대부분 양수 및 음수 값의 경우 Double 의 값 Double.Epsilon 이 너무 작아 검색할 수 없습니다. 따라서 값이 0 인 경우를 제외 하 고는 테스트에 동일한 값을 사용 하지 않는 것이 좋습니다.

다음 예제에서는 `IsApproximatelyEqual` 두 번째 값 간의 상대적 차이를 테스트 하는 메서드를 정의 하는 데 두 번째 방법을 사용 합니다. 또한 메서드 및 메서드에 대 한 호출의 결과를 대조 합니다 `IsApproximatelyEqual` Equals(Double) .

``````using System;

public class Example
{
public static void Main()
{
double one1 = .1 * 10;
double one2 = 0;
for (int ctr = 1; ctr <= 10; ctr++)
one2 += .1;

Console.WriteLine("{0:R} = {1:R}: {2}", one1, one2, one1.Equals(one2));
Console.WriteLine("{0:R} is approximately equal to {1:R}: {2}",
one1, one2,
IsApproximatelyEqual(one1, one2, .000000001));
}

static bool IsApproximatelyEqual(double value1, double value2, double epsilon)
{
// If they are equal anyway, just return True.
if (value1.Equals(value2))
return true;

// Handle NaN, Infinity.
if (Double.IsInfinity(value1) | Double.IsNaN(value1))
return value1.Equals(value2);
else if (Double.IsInfinity(value2) | Double.IsNaN(value2))
return value1.Equals(value2);

// Handle zero to avoid division by zero
double divisor = Math.Max(value1, value2);
if (divisor.Equals(0))
divisor = Math.Min(value1, value2);

return Math.Abs((value1 - value2) / divisor) <= epsilon;
}
}
// The example displays the following output:
//       1 = 0.99999999999999989: False
//       1 is approximately equal to 0.99999999999999989: True
``````
``````Module Example
Public Sub Main()
Dim one1 As Double = .1 * 10
Dim one2 As Double = 0
For ctr As Integer = 1 To 10
one2 += .1
Next
Console.WriteLine("{0:R} = {1:R}: {2}", one1, one2, one1.Equals(one2))
Console.WriteLine("{0:R} is approximately equal to {1:R}: {2}",
one1, one2,
IsApproximatelyEqual(one1, one2, .000000001))
End Sub

Function IsApproximatelyEqual(value1 As Double, value2 As Double,
epsilon As Double) As Boolean
' If they are equal anyway, just return True.
If value1.Equals(value2) Then Return True

' Handle NaN, Infinity.
If Double.IsInfinity(value1) Or Double.IsNaN(value1) Then
Return value1.Equals(value2)
Else If Double.IsInfinity(value2) Or Double.IsNaN(value2)
Return value1.Equals(value2)
End If

' Handle zero to avoid division by zero
Dim divisor As Double = Math.Max(value1, value2)
If divisor.Equals(0) Then
divisor = Math.Min(value1, value2)
End If

Return Math.Abs((value1 - value2) / divisor) <= epsilon
End Function
End Module
' The example displays the following output:
'       1 = 0.99999999999999989: False
'       1 is approximately equal to 0.99999999999999989: True
``````

### Floating-Point 값 및 예외

오버플로 또는 0으로 나누기와 같은 잘못 된 작업의 경우 예외를 throw 하는 정수 계열 형식의 작업과 달리, 부동 소수점 값을 사용 하는 연산은 예외를 throw 하지 않습니다. 대신, 예외적인 경우 부동 소수점 연산의 결과는 0, 양의 무한대, 음의 무한대 또는 NaN (숫자가 아님)입니다.

• 부동 소수점 연산의 결과가 대상 형식에 비해 너무 작은 경우 결과는 0입니다. 다음 예제와 같이 두 개의 매우 작은 숫자를 곱할 때 이러한 현상이 발생할 수 있습니다.

``````using System;

public class Example
{
public static void Main()
{
Double value1 = 1.1632875981534209e-225;
Double value2 = 9.1642346778e-175;
Double result = value1 * value2;
Console.WriteLine("{0} * {1} = {2}", value1, value2, result);
Console.WriteLine("{0} = 0: {1}", result, result.Equals(0.0));
}
}
// The example displays the following output:
//       1.16328759815342E-225 * 9.1642346778E-175 = 0
//       0 = 0: True
``````
``````Module Example
Public Sub Main()
Dim value1 As Double = 1.1632875981534209e-225
Dim value2 As Double = 9.1642346778e-175
Dim result As Double = value1 * value2
Console.WriteLine("{0} * {1} = {2}", value1, value2, result)
Console.WriteLine("{0} = 0: {1}", result, result.Equals(0.0))
End Sub
End Module
' The example displays the following output:
'       1.16328759815342E-225 * 9.1642346778E-175 = 0
'       0 = 0: True
``````
• 부동 소수점 연산 결과의 크기가 대상 형식의 범위를 초과 하는 경우 연산의 결과는 PositiveInfinity 또는 이며 NegativeInfinity 결과의 부호에 적절 합니다. 오버플로 되는 작업의 결과는 Double.MaxValue PositiveInfinity 다음 예제와 같이 오버플로 되는 작업의 결과 Double.MinValue 입니다 NegativeInfinity .

``````using System;

public class Example
{
public static void Main()
{
Double value1 = 4.565e153;
Double value2 = 6.9375e172;
Double result = value1 * value2;
Console.WriteLine("PositiveInfinity: {0}",
Double.IsPositiveInfinity(result));
Console.WriteLine("NegativeInfinity: {0}\n",
Double.IsNegativeInfinity(result));

value1 = -value1;
result = value1 * value2;
Console.WriteLine("PositiveInfinity: {0}",
Double.IsPositiveInfinity(result));
Console.WriteLine("NegativeInfinity: {0}",
Double.IsNegativeInfinity(result));
}
}

// The example displays the following output:
//       PositiveInfinity: True
//       NegativeInfinity: False
//
//       PositiveInfinity: False
//       NegativeInfinity: True
``````
``````Module Example
Public Sub Main()
Dim value1 As Double = 4.565e153
Dim value2 As Double = 6.9375e172
Dim result As Double = value1 * value2
Console.WriteLine("PositiveInfinity: {0}",
Double.IsPositiveInfinity(result))
Console.WriteLine("NegativeInfinity: {0}",
Double.IsNegativeInfinity(result))
Console.WriteLine()
value1 = -value1
result = value1 * value2
Console.WriteLine("PositiveInfinity: {0}",
Double.IsPositiveInfinity(result))
Console.WriteLine("NegativeInfinity: {0}",
Double.IsNegativeInfinity(result))
End Sub
End Module
' The example displays the following output:
'       PositiveInfinity: True
'       NegativeInfinity: False
'
'       PositiveInfinity: False
'       NegativeInfinity: True
``````

PositiveInfinity 또한은 양의 피제수를 사용 하 여 0으로 나눈 결과와 NegativeInfinity 음수 피제수를 사용 하 여 0으로 나눈 결과에서 발생 합니다.

• 부동 소수점 연산이 잘못 된 경우 작업의 결과는 NaN 입니다. 예를 들어 NaN 다음 작업의 결과는 다음과 같습니다.

• 잘못 된 입력을 사용 하는 부동 소수점 연산입니다. 예를 들어 Math.Sqrt 음수 값을 사용 하 여 메서드를 호출 하면 NaN Math.Acos 1 보다 크거나 음수 보다 작은 값을 사용 하 여 메서드를 호출 하는 것 처럼이 반환 됩니다.

• 값이 인 인수를 사용 Double.NaN 하는 모든 작업

### 형식 변환 및 Double 구조체

Double구조체는 명시적 또는 암시적 변환 연산자를 정의하지 않습니다. 대신 컴파일러에서 변환을 구현합니다.

기본 숫자 형식의 값을 로 변환하는 Double 것은 확대 변환이므로 컴파일러에서 명시적으로 필요로 하지 않는 한 명시적 캐스트 연산자 또는 변환 메서드 호출이 필요하지 않습니다. 예를 들어 C# 컴파일러는 에서 로 변환하는 데 캐스팅 Decimal Double 연산자가 필요하지만 Visual Basic 컴파일러는 그렇지 않습니다. 다음 예제에서는 다른 기본 숫자 형식의 최소값 또는 최대값을 로 Double 변환합니다.

``````using System;

public class Example
{
public static void Main()
{
dynamic[] values = { Byte.MinValue, Byte.MaxValue, Decimal.MinValue,
Decimal.MaxValue, Int16.MinValue, Int16.MaxValue,
Int32.MinValue, Int32.MaxValue, Int64.MinValue,
Int64.MaxValue, SByte.MinValue, SByte.MaxValue,
Single.MinValue, Single.MaxValue, UInt16.MinValue,
UInt16.MaxValue, UInt32.MinValue, UInt32.MaxValue,
UInt64.MinValue, UInt64.MaxValue };
double dblValue;
foreach (var value in values) {
if (value.GetType() == typeof(Decimal))
dblValue = (Double) value;
else
dblValue = value;
Console.WriteLine("{0} ({1}) --> {2:R} ({3})",
value, value.GetType().Name,
dblValue, dblValue.GetType().Name);
}
}
}
// The example displays the following output:
//    0 (Byte) --> 0 (Double)
//    255 (Byte) --> 255 (Double)
//    -79228162514264337593543950335 (Decimal) --> -7.9228162514264338E+28 (Double)
//    79228162514264337593543950335 (Decimal) --> 7.9228162514264338E+28 (Double)
//    -32768 (Int16) --> -32768 (Double)
//    32767 (Int16) --> 32767 (Double)
//    -2147483648 (Int32) --> -2147483648 (Double)
//    2147483647 (Int32) --> 2147483647 (Double)
//    -9223372036854775808 (Int64) --> -9.2233720368547758E+18 (Double)
//    9223372036854775807 (Int64) --> 9.2233720368547758E+18 (Double)
//    -128 (SByte) --> -128 (Double)
//    127 (SByte) --> 127 (Double)
//    -3.402823E+38 (Single) --> -3.4028234663852886E+38 (Double)
//    3.402823E+38 (Single) --> 3.4028234663852886E+38 (Double)
//    0 (UInt16) --> 0 (Double)
//    65535 (UInt16) --> 65535 (Double)
//    0 (UInt32) --> 0 (Double)
//    4294967295 (UInt32) --> 4294967295 (Double)
//    0 (UInt64) --> 0 (Double)
//    18446744073709551615 (UInt64) --> 1.8446744073709552E+19 (Double)
``````
``````Module Example
Public Sub Main()
Dim values() As Object = { Byte.MinValue, Byte.MaxValue, Decimal.MinValue,
Decimal.MaxValue, Int16.MinValue, Int16.MaxValue,
Int32.MinValue, Int32.MaxValue, Int64.MinValue,
Int64.MaxValue, SByte.MinValue, SByte.MaxValue,
Single.MinValue, Single.MaxValue, UInt16.MinValue,
UInt16.MaxValue, UInt32.MinValue, UInt32.MaxValue,
UInt64.MinValue, UInt64.MaxValue }
Dim dblValue As Double
For Each value In values
dblValue = value
Console.WriteLine("{0} ({1}) --> {2:R} ({3})",
value, value.GetType().Name,
dblValue, dblValue.GetType().Name)
Next
End Sub
End Module
' The example displays the following output:
'    0 (Byte) --> 0 (Double)
'    255 (Byte) --> 255 (Double)
'    -79228162514264337593543950335 (Decimal) --> -7.9228162514264338E+28 (Double)
'    79228162514264337593543950335 (Decimal) --> 7.9228162514264338E+28 (Double)
'    -32768 (Int16) --> -32768 (Double)
'    32767 (Int16) --> 32767 (Double)
'    -2147483648 (Int32) --> -2147483648 (Double)
'    2147483647 (Int32) --> 2147483647 (Double)
'    -9223372036854775808 (Int64) --> -9.2233720368547758E+18 (Double)
'    9223372036854775807 (Int64) --> 9.2233720368547758E+18 (Double)
'    -128 (SByte) --> -128 (Double)
'    127 (SByte) --> 127 (Double)
'    -3.402823E+38 (Single) --> -3.4028234663852886E+38 (Double)
'    3.402823E+38 (Single) --> 3.4028234663852886E+38 (Double)
'    0 (UInt16) --> 0 (Double)
'    65535 (UInt16) --> 65535 (Double)
'    0 (UInt32) --> 0 (Double)
'    4294967295 (UInt32) --> 4294967295 (Double)
'    0 (UInt64) --> 0 (Double)
'    18446744073709551615 (UInt64) --> 1.8446744073709552E+19 (Double)
``````

일부 숫자 형식의 값을 값으로 변환하면 Double 전체 자릿수가 손실됩니다. 예제에서 알 수 있듯이 , 및 값을 값으로 변환할 때 정밀도 손실이 발생할 Decimal Int64UInt64 Double 있습니다.

값을 다른 Double 기본 숫자 데이터 형식의 값으로 변환하는 것은 축소 변환이며 캐스트 연산자(C#), 변환 메서드(Visual Basic) 또는 메서드 호출이 Convert 필요합니다. 대상 형식의 및 속성으로 정의된 대상 데이터 형식의 범위를 벗어난 값은 `MinValue` `MaxValue` 다음 표와 같이 동작합니다.

대상 형식 결과
모든 계수 형식 OverflowException확인된 컨텍스트에서 변환이 발생하는 경우 예외입니다.

확인되지 않은 컨텍스트(C#의 기본값)에서 변환이 발생하면 변환 작업은 성공하지만 값이 오버플로됩니다.
Decimal OverflowException 예외입니다.
Single Single.NegativeInfinity 음수 값의 경우 입니다.

Single.PositiveInfinity 양수 값의 경우 입니다.

또한 , 및 는 Double.NaN Double.PositiveInfinity 확인된 Double.NegativeInfinity OverflowException 컨텍스트에서 정수로 변환하기 위해 을 throw하지만, 이러한 값은 확인되지 않은 컨텍스트에서 정수로 변환될 때 오버플로됩니다. 로 변환하는 경우 Decimal 항상 을 throw합니다. OverflowException 로 변환하는 경우 Single 각각 , 및 로 Single.NaN Single.PositiveInfinity Single.NegativeInfinity 변환됩니다.

값을 다른 숫자 형식으로 변환하면 정밀도 손실이 발생할 수 Double 있습니다. 예제의 출력과 같이 정수 계열 형식으로 변환하는 경우 Double 값이 반올림(Visual Basic)되거나 잘리면(C#에서처럼) 소수 구성 요소가 손실됩니다. 및 값으로 변환하는 경우 Decimal Single Double 값에 대상 데이터 형식의 정확한 표현이 없을 수 있습니다.

다음 예제에서는 여러 Double 값을 다른 여러 숫자 형식으로 변환합니다. 변환은 Visual Basic(기본값) 및 C#의 확인된 컨텍스트에서 발생합니다(checked 키워드로 인해). 예제의 출력은 확인되지 않은 컨텍스트에서 확인된 둘 다의 변환 결과를 보여줍니다. `/removeintchecks+`컴파일러 스위치로 컴파일하고 C#에서 문을 주석으로 처리하여 Visual Basic 확인되지 않은 컨텍스트에서 변환을 수행할 수 `checked` 있습니다.

``````using System;

public class Example
{
public static void Main()
{
Double[] values = { Double.MinValue, -67890.1234, -12345.6789,
12345.6789, 67890.1234, Double.MaxValue,
Double.NaN, Double.PositiveInfinity,
Double.NegativeInfinity };
checked {
foreach (var value in values) {
try {
Int64 lValue = (long) value;
Console.WriteLine("{0} ({1}) --> {2} (0x{2:X16}) ({3})",
value, value.GetType().Name,
lValue, lValue.GetType().Name);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert {0} to Int64.", value);
}
try {
UInt64 ulValue = (ulong) value;
Console.WriteLine("{0} ({1}) --> {2} (0x{2:X16}) ({3})",
value, value.GetType().Name,
ulValue, ulValue.GetType().Name);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert {0} to UInt64.", value);
}
try {
Decimal dValue = (decimal) value;
Console.WriteLine("{0} ({1}) --> {2} ({3})",
value, value.GetType().Name,
dValue, dValue.GetType().Name);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert {0} to Decimal.", value);
}
try {
Single sValue = (float) value;
Console.WriteLine("{0} ({1}) --> {2} ({3})",
value, value.GetType().Name,
sValue, sValue.GetType().Name);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert {0} to Single.", value);
}
Console.WriteLine();
}
}
}
}
// The example displays the following output for conversions performed
// in a checked context:
//       Unable to convert -1.79769313486232E+308 to Int64.
//       Unable to convert -1.79769313486232E+308 to UInt64.
//       Unable to convert -1.79769313486232E+308 to Decimal.
//       -1.79769313486232E+308 (Double) --> -Infinity (Single)
//
//       -67890.1234 (Double) --> -67890 (0xFFFFFFFFFFFEF6CE) (Int64)
//       Unable to convert -67890.1234 to UInt64.
//       -67890.1234 (Double) --> -67890.1234 (Decimal)
//       -67890.1234 (Double) --> -67890.13 (Single)
//
//       -12345.6789 (Double) --> -12345 (0xFFFFFFFFFFFFCFC7) (Int64)
//       Unable to convert -12345.6789 to UInt64.
//       -12345.6789 (Double) --> -12345.6789 (Decimal)
//       -12345.6789 (Double) --> -12345.68 (Single)
//
//       12345.6789 (Double) --> 12345 (0x0000000000003039) (Int64)
//       12345.6789 (Double) --> 12345 (0x0000000000003039) (UInt64)
//       12345.6789 (Double) --> 12345.6789 (Decimal)
//       12345.6789 (Double) --> 12345.68 (Single)
//
//       67890.1234 (Double) --> 67890 (0x0000000000010932) (Int64)
//       67890.1234 (Double) --> 67890 (0x0000000000010932) (UInt64)
//       67890.1234 (Double) --> 67890.1234 (Decimal)
//       67890.1234 (Double) --> 67890.13 (Single)
//
//       Unable to convert 1.79769313486232E+308 to Int64.
//       Unable to convert 1.79769313486232E+308 to UInt64.
//       Unable to convert 1.79769313486232E+308 to Decimal.
//       1.79769313486232E+308 (Double) --> Infinity (Single)
//
//       Unable to convert NaN to Int64.
//       Unable to convert NaN to UInt64.
//       Unable to convert NaN to Decimal.
//       NaN (Double) --> NaN (Single)
//
//       Unable to convert Infinity to Int64.
//       Unable to convert Infinity to UInt64.
//       Unable to convert Infinity to Decimal.
//       Infinity (Double) --> Infinity (Single)
//
//       Unable to convert -Infinity to Int64.
//       Unable to convert -Infinity to UInt64.
//       Unable to convert -Infinity to Decimal.
//       -Infinity (Double) --> -Infinity (Single)
// The example displays the following output for conversions performed
// in an unchecked context:
//       -1.79769313486232E+308 (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
//       -1.79769313486232E+308 (Double) --> 9223372036854775808 (0x8000000000000000) (UInt64)
//       Unable to convert -1.79769313486232E+308 to Decimal.
//       -1.79769313486232E+308 (Double) --> -Infinity (Single)
//
//       -67890.1234 (Double) --> -67890 (0xFFFFFFFFFFFEF6CE) (Int64)
//       -67890.1234 (Double) --> 18446744073709483726 (0xFFFFFFFFFFFEF6CE) (UInt64)
//       -67890.1234 (Double) --> -67890.1234 (Decimal)
//       -67890.1234 (Double) --> -67890.13 (Single)
//
//       -12345.6789 (Double) --> -12345 (0xFFFFFFFFFFFFCFC7) (Int64)
//       -12345.6789 (Double) --> 18446744073709539271 (0xFFFFFFFFFFFFCFC7) (UInt64)
//       -12345.6789 (Double) --> -12345.6789 (Decimal)
//       -12345.6789 (Double) --> -12345.68 (Single)
//
//       12345.6789 (Double) --> 12345 (0x0000000000003039) (Int64)
//       12345.6789 (Double) --> 12345 (0x0000000000003039) (UInt64)
//       12345.6789 (Double) --> 12345.6789 (Decimal)
//       12345.6789 (Double) --> 12345.68 (Single)
//
//       67890.1234 (Double) --> 67890 (0x0000000000010932) (Int64)
//       67890.1234 (Double) --> 67890 (0x0000000000010932) (UInt64)
//       67890.1234 (Double) --> 67890.1234 (Decimal)
//       67890.1234 (Double) --> 67890.13 (Single)
//
//       1.79769313486232E+308 (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
//       1.79769313486232E+308 (Double) --> 0 (0x0000000000000000) (UInt64)
//       Unable to convert 1.79769313486232E+308 to Decimal.
//       1.79769313486232E+308 (Double) --> Infinity (Single)
//
//       NaN (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
//       NaN (Double) --> 0 (0x0000000000000000) (UInt64)
//       Unable to convert NaN to Decimal.
//       NaN (Double) --> NaN (Single)
//
//       Infinity (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
//       Infinity (Double) --> 0 (0x0000000000000000) (UInt64)
//       Unable to convert Infinity to Decimal.
//       Infinity (Double) --> Infinity (Single)
//
//       -Infinity (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
//       -Infinity (Double) --> 9223372036854775808 (0x8000000000000000) (UInt64)
//       Unable to convert -Infinity to Decimal.
//       -Infinity (Double) --> -Infinity (Single)
``````
``````Module Example
Public Sub Main()
Dim values() As Double = { Double.MinValue, -67890.1234, -12345.6789,
12345.6789, 67890.1234, Double.MaxValue,
Double.NaN, Double.PositiveInfinity,
Double.NegativeInfinity }
For Each value In values
Try
Dim lValue As Int64 = CLng(value)
Console.WriteLine("{0} ({1}) --> {2} (0x{2:X16}) ({3})",
value, value.GetType().Name,
lValue, lValue.GetType().Name)
Catch e As OverflowException
Console.WriteLine("Unable to convert {0} to Int64.", value)
End Try
Try
Dim ulValue As UInt64 = CULng(value)
Console.WriteLine("{0} ({1}) --> {2} (0x{2:X16}) ({3})",
value, value.GetType().Name,
ulValue, ulValue.GetType().Name)
Catch e As OverflowException
Console.WriteLine("Unable to convert {0} to UInt64.", value)
End Try
Try
Dim dValue As Decimal = CDec(value)
Console.WriteLine("{0} ({1}) --> {2} ({3})",
value, value.GetType().Name,
dValue, dValue.GetType().Name)
Catch e As OverflowException
Console.WriteLine("Unable to convert {0} to Decimal.", value)
End Try
Try
Dim sValue As Single = CSng(value)
Console.WriteLine("{0} ({1}) --> {2} ({3})",
value, value.GetType().Name,
sValue, sValue.GetType().Name)
Catch e As OverflowException
Console.WriteLine("Unable to convert {0} to Single.", value)
End Try
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output for conversions performed
' in a checked context:
'       Unable to convert -1.79769313486232E+308 to Int64.
'       Unable to convert -1.79769313486232E+308 to UInt64.
'       Unable to convert -1.79769313486232E+308 to Decimal.
'       -1.79769313486232E+308 (Double) --> -Infinity (Single)
'
'       -67890.1234 (Double) --> -67890 (0xFFFFFFFFFFFEF6CE) (Int64)
'       Unable to convert -67890.1234 to UInt64.
'       -67890.1234 (Double) --> -67890.1234 (Decimal)
'       -67890.1234 (Double) --> -67890.13 (Single)
'
'       -12345.6789 (Double) --> -12346 (0xFFFFFFFFFFFFCFC6) (Int64)
'       Unable to convert -12345.6789 to UInt64.
'       -12345.6789 (Double) --> -12345.6789 (Decimal)
'       -12345.6789 (Double) --> -12345.68 (Single)
'
'       12345.6789 (Double) --> 12346 (0x000000000000303A) (Int64)
'       12345.6789 (Double) --> 12346 (0x000000000000303A) (UInt64)
'       12345.6789 (Double) --> 12345.6789 (Decimal)
'       12345.6789 (Double) --> 12345.68 (Single)
'
'       67890.1234 (Double) --> 67890 (0x0000000000010932) (Int64)
'       67890.1234 (Double) --> 67890 (0x0000000000010932) (UInt64)
'       67890.1234 (Double) --> 67890.1234 (Decimal)
'       67890.1234 (Double) --> 67890.13 (Single)
'
'       Unable to convert 1.79769313486232E+308 to Int64.
'       Unable to convert 1.79769313486232E+308 to UInt64.
'       Unable to convert 1.79769313486232E+308 to Decimal.
'       1.79769313486232E+308 (Double) --> Infinity (Single)
'
'       Unable to convert NaN to Int64.
'       Unable to convert NaN to UInt64.
'       Unable to convert NaN to Decimal.
'       NaN (Double) --> NaN (Single)
'
'       Unable to convert Infinity to Int64.
'       Unable to convert Infinity to UInt64.
'       Unable to convert Infinity to Decimal.
'       Infinity (Double) --> Infinity (Single)
'
'       Unable to convert -Infinity to Int64.
'       Unable to convert -Infinity to UInt64.
'       Unable to convert -Infinity to Decimal.
'       -Infinity (Double) --> -Infinity (Single)
' The example displays the following output for conversions performed
' in an unchecked context:
'       -1.79769313486232E+308 (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
'       -1.79769313486232E+308 (Double) --> 9223372036854775808 (0x8000000000000000) (UInt64)
'       Unable to convert -1.79769313486232E+308 to Decimal.
'       -1.79769313486232E+308 (Double) --> -Infinity (Single)
'
'       -67890.1234 (Double) --> -67890 (0xFFFFFFFFFFFEF6CE) (Int64)
'       -67890.1234 (Double) --> 18446744073709483726 (0xFFFFFFFFFFFEF6CE) (UInt64)
'       -67890.1234 (Double) --> -67890.1234 (Decimal)
'       -67890.1234 (Double) --> -67890.13 (Single)
'
'       -12345.6789 (Double) --> -12346 (0xFFFFFFFFFFFFCFC6) (Int64)
'       -12345.6789 (Double) --> 18446744073709539270 (0xFFFFFFFFFFFFCFC6) (UInt64)
'       -12345.6789 (Double) --> -12345.6789 (Decimal)
'       -12345.6789 (Double) --> -12345.68 (Single)
'
'       12345.6789 (Double) --> 12346 (0x000000000000303A) (Int64)
'       12345.6789 (Double) --> 12346 (0x000000000000303A) (UInt64)
'       12345.6789 (Double) --> 12345.6789 (Decimal)
'       12345.6789 (Double) --> 12345.68 (Single)
'
'       67890.1234 (Double) --> 67890 (0x0000000000010932) (Int64)
'       67890.1234 (Double) --> 67890 (0x0000000000010932) (UInt64)
'       67890.1234 (Double) --> 67890.1234 (Decimal)
'       67890.1234 (Double) --> 67890.13 (Single)
'
'       1.79769313486232E+308 (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
'       1.79769313486232E+308 (Double) --> 0 (0x0000000000000000) (UInt64)
'       Unable to convert 1.79769313486232E+308 to Decimal.
'       1.79769313486232E+308 (Double) --> Infinity (Single)
'
'       NaN (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
'       NaN (Double) --> 0 (0x0000000000000000) (UInt64)
'       Unable to convert NaN to Decimal.
'       NaN (Double) --> NaN (Single)
'
'       Infinity (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
'       Infinity (Double) --> 0 (0x0000000000000000) (UInt64)
'       Unable to convert Infinity to Decimal.
'       Infinity (Double) --> Infinity (Single)
'
'       -Infinity (Double) --> -9223372036854775808 (0x8000000000000000) (Int64)
'       -Infinity (Double) --> 9223372036854775808 (0x8000000000000000) (UInt64)
'       Unable to convert -Infinity to Decimal.
'       -Infinity (Double) --> -Infinity (Single)
``````

숫자 형식의 변환에 대한 자세한 내용은 .NET Framework 형식 변환 및 형식 변환 테이블을 참조하세요.

### Floating-Point 기능

Double구조체 및 관련 형식은 다음 영역에서 작업을 수행하는 메서드를 제공합니다.

• 값의 비교입니다. 메서드를 Equals 호출하여 두 Double 값이 같은지 또는 CompareTo 메서드를 호출하여 두 값 간의 관계를 확인할 수 있습니다.

Double구조체는 전체 비교 연산자 집합도 지원합니다. 예를 들어 같음 또는 같지 여부를 테스트하거나 한 값이 다른 값보다 크거나 같은지 확인할 수 있습니다. 연산자 중 하나가 이외의 숫자 형식인 경우 Double 비교를 수행하기 전에 로 Double 변환됩니다.

경고

정밀도의 차이로 인해 Double 같을 것으로 예상되는 두 값이 같지 않은 것으로 표시되어 비교 결과에 영향을 줄 수 있습니다. 두 값을 비교하는 자세한 내용은 같음 테스트 섹션을 Double 참조하세요.

IsNaN, , 및 IsInfinity IsPositiveInfinity IsNegativeInfinity 메서드를 호출하여 이러한 특수 값을 테스트할 수도 있습니다.

• 수학 연산 입니다. 더하기, 빼기, 곱하기 및 나누기와 같은 일반적인 산술 연산은 메서드가 아닌 언어 컴파일러 및 CIL(공용 중간 언어) 명령에 의해 Double 구현됩니다. 수학 연산의 연산자 중 하나가 이외의 숫자 형식인 경우 연산을 수행하기 전에 로 Double Double 변환됩니다. 작업의 결과도 Double 값입니다.

다른 수학 연산은 `static` `Shared` 클래스에서 (Visual Basic) 메서드를 호출하여 수행할 수 System.Math 있습니다. 여기에는 산술(예: Math.Abs , Math.Sign 및 ), Math.Sqrt 기하 도형(예: Math.CosMath.Sin ) 및 미적분(예: Math.Log )에 일반적으로 사용되는 추가 메서드가 포함됩니다.

값의 개별 비트를 조작할 수도 Double 있습니다. BitConverter.DoubleToInt64Bits메서드는 Double 값의 비트 패턴을 64비트 정수로 유지합니다. BitConverter.GetBytes(Double)메서드는 바이트 배열에서 비트 패턴을 반환합니다.

• 반올림합니다. 반올림은 부동 소수점 표현 및 정밀도 문제로 인한 값 간의 차이 영향을 줄이는 기술로 사용되는 경우가 많습니다. Double메서드를 호출하여 값을 반올림할 수 Math.Round 있습니다.

• 서식을 지정합니다. Double메서드를 호출하거나 복합 서식 지정 기능을 사용하여 값을 문자열 ToString 표현으로 변환할 수 있습니다. 서식 문자열이 부동 소수점 값의 문자열 표현을 제어하는 방법에 대한 자세한 내용은 표준 숫자 형식 문자열 및 사용자 지정 숫자 형식 문자열 항목을 참조하세요.

• 문자열을 구문 분석합니다. 또는 메서드를 호출하여 부동 소수점 값의 문자열 표현을 값으로 변환할 수 Double Parse TryParse 있습니다. 구문 분석 작업이 실패하면 Parse 메서드는 예외를 throw하지만 TryParse 메서드는 를 반환합니다. `false`

• 형식 변환. Double구조체는 두 표준 .NET Framework 데이터 형식 간의 변환을 지원하는 인터페이스에 대한 명시적 인터페이스 IConvertible 구현을 제공합니다. 언어 컴파일러에서는 다른 모든 표준 숫자 형식의 값을 값으로 암시적으로 변환할 수도 Double 있습니다. 표준 숫자 형식의 값을 로 Double 변환하는 것은 확대 변환이며 캐스팅 연산자 또는 변환 메서드의 사용자가 필요하지 않습니다.

그러나 및 값의 변환에는 Int64 Single 정밀도 손실이 포함될 수 있습니다. 다음 표에서는 이러한 각 형식의 정밀도 차이를 나열합니다.

유형 최대 정밀도 내부 정밀도
Double 15 17
Int64 19자리 10진수 19자리 10진수
Single 10진수 7자리 10진수 9자리

정밀도 문제는 값으로 변환되는 값에 가장 자주 영향을 Single Double 줍니다. 다음 예제에서는 값 중 하나가 로 변환된 단정밀도 부동 소수점 값이므로 동일한 나누기 연산에서 생성된 두 값이 같지 Double 않습니다.

``````using System;

public class Example
{
public static void Main()
{
Double value = .1;
Double result1 = value * 10;
Double result2 = 0;
for (int ctr = 1; ctr <= 10; ctr++)
result2 += value;

Console.WriteLine(".1 * 10:           {0:R}", result1);
Console.WriteLine(".1 Added 10 times: {0:R}", result2);
}
}
// The example displays the following output:
//       .1 * 10:           1
//       .1 Added 10 times: 0.99999999999999989
``````
``````Module Example
Public Sub Main()
Dim value As Double = .1
Dim result1 As Double = value * 10
Dim result2 As Double
For ctr As Integer = 1 To 10
result2 += value
Next
Console.WriteLine(".1 * 10:           {0:R}", result1)
Console.WriteLine(".1 Added 10 times: {0:R}", result2)
End Sub
End Module
' The example displays the following output:
'       .1 * 10:           1
'       .1 Added 10 times: 0.99999999999999989
``````

## 필드

 0보다 큰 양의 최소 Double 값을 나타냅니다. 이 필드는 상수입니다. Double의 가능한 최대값을 나타냅니다. 이 필드는 상수입니다. Double의 최소값을 나타냅니다. 이 필드는 상수입니다. 숫자가 아닌 값을 나타냅니다(`NaN`). 이 필드는 상수입니다. 음의 무한대를 나타냅니다. 이 필드는 상수입니다. 양의 무한대를 나타냅니다. 이 필드는 상수입니다.

## 메서드

 이 인스턴스를 지정된 배정밀도 부동 소수점 숫자와 비교하고 이 인스턴스의 값이 지정된 배정밀도 부동 소수점 숫자 값보다 작은지, 같은지 또는 큰지를 나타내는 정수를 반환합니다. 이 인스턴스를 지정된 개체와 비교하고 이 인스턴스의 값이 지정된 개체의 값보다 작은지, 같은지 또는 큰지를 나타내는 정수를 반환합니다. 이 인스턴스의 값과 지정된 Double 개체의 값이 같은지를 나타내는 값을 반환합니다. 이 인스턴스가 지정된 개체와 같은지를 표시하는 값을 반환합니다. 이 인스턴스의 해시 코드를 반환합니다. TypeCode 값 형식에 대한 Double를 반환합니다. 지정된 값이 유한(0, 비정상 또는 정상)한지 확인합니다. 지정된 숫자가 음의 무한대로 계산되는지 양의 무한대로 계산되는지를 나타내는 값을 반환합니다. 지정된 값이 숫자가 아닌지(NaN) 여부를 나타내는 값을 반환합니다. 지정된 값이 음수인지 확인합니다. 지정된 숫자가 음의 무한대로 계산되는지를 나타내는 값을 반환합니다. 지정된 값이 정상인지 확인합니다. 지정된 숫자가 양의 무한대로 계산되는지를 나타내는 값을 반환합니다. 지정된 값이 비정상인지 확인합니다. 지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을 포함하는 문자 범위를 해당하는 배정밀도 부동 소수점 숫자로 변환합니다. 숫자의 문자열 표현을 같은 값의 배정밀도 부동 소수점 숫자로 변환합니다. 지정된 문화권별 형식의 숫자에 대한 문자열 표현을 해당하는 배정밀도 부동 소수점 숫자로 변환합니다. 지정된 스타일의 숫자에 대한 문자열 표현을 해당하는 배정밀도 부동 소수점 숫자로 변환합니다. 지정된 스타일 및 문화권별 형식의 숫자에 대한 문자열 표현을 같은 값의 배정밀도 부동 소수점 숫자로 변환합니다. 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다. 지정된 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다. 지정된 형식을 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다. 지정된 형식 및 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다. 현재의 double 인스턴스 값을 제공된 문자 범위의 형식으로 지정합니다. 지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을 포함하는 문자 범위를 해당하는 배정밀도 부동 소수점 숫자로 변환합니다. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다. 지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을포함하는 문자 범위를 해당하는 배정밀도 부동 소수점 숫자로 변환합니다. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다. 숫자의 문자열 표현을 같은 값의 배정밀도 부동 소수점 숫자로 변환합니다. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다. 지정된 스타일 및 문화권별 형식의 숫자에 대한 문자열 표현을 같은 값의 배정밀도 부동 소수점 숫자로 변환합니다. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.

## 연산자

 지정된 두 Double 값이 같은지 여부를 나타내는 값을 반환합니다. 지정된 Double 값이 지정된 다른 Double 값보다 큰지 여부를 나타내는 값을 반환합니다. 지정된 Double 값이 지정된 다른 Double 값보다 크거나 같은지 여부를 나타내는 값을 반환합니다. 지정된 두 Double 값이 같지 않은지 여부를 나타내는 값을 반환합니다. 지정된 Double 값이 지정된 다른 Double 값보다 작은지 여부를 나타내는 값을 반환합니다. 지정된 Double 값이 지정된 다른 Double 값보다 작거나 같은지 여부를 나타내는 값을 반환합니다.

## 명시적 인터페이스 구현

 현재 인스턴스와 동일한 형식의 다른 개체를 비교하고 정렬 순서에서 현재 인스턴스의 위치가 다른 개체보다 앞인지, 뒤인지 또는 동일한지를 나타내는 정수를 반환합니다. 이 인스턴스에 대한 TypeCode를 반환합니다. 이 멤버에 대한 설명은 ToBoolean(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToByte(IFormatProvider)를 참조하세요. 이 변환은 지원되지 않습니다. 이 메서드를 사용하려고 하면 InvalidCastException이 throw됩니다. 이 변환은 지원되지 않습니다. 이 메서드를 사용하려고 하면 InvalidCastException이 throw됩니다. 이 멤버에 대한 설명은 ToDecimal(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToDouble(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToInt16(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToInt32(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToInt64(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToSByte(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToSingle(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToType(Type, IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToUInt16(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToUInt32(IFormatProvider)를 참조하세요. 이 멤버에 대한 설명은 ToUInt64(IFormatProvider)를 참조하세요.

## 스레드 보안

이 형식의 모든 멤버는 스레드 안전 합니다. 인스턴스 상태를 수정하는 것처럼 보이는 멤버는 실제로 새 값으로 초기화된 새 인스턴스를 반환합니다. 다른 형식과 마찬가지로 이 형식의 인스턴스를 포함하는 공유 변수에 대한 읽기 및 쓰기는 스레드 안전을 보장하기 위해 잠금으로 보호되어야 합니다.