숫자 문자열 구문 분석

업데이트: 2010년 8월

모든 숫자 형식에는 숫자의 문자열 표현을 숫자 형식으로 변환하는 데 사용할 수 있는 두 가지 정적 구문 분석 메서드인 Parse 및 TryParse가 있습니다. 이러한 메서드를 사용하면 표준 숫자 서식 문자열 및 사용자 지정 숫자 서식 문자열에서 설명된 형식 문자열을 사용하여 생성된 문자열을 구문 분석할 수 있습니다. 기본적으로 Parse 및 TryParse 메서드는 정수 계열 10진수만 포함된 문자열을 정수 값으로 변환할 수 있습니다. 이러한 메서드는 정수 계열 및 소수 계열 10진수, 그룹 구분 기호 및 소수 구분 기호가 포함된 문자열을 부동 소수 값으로 변환할 수 있습니다. Parse 메서드는 작업이 실패할 경우 예외를 throw하지만 TryParse 메서드는 false를 반환합니다.

구문 분석 및 형식 공급자

일반적으로 숫자 값의 문자열 표현은 문화권마다 다릅니다. 통화 기호, 그룹(또는 천 단위 자리) 구분 기호, 소수 구분 기호 및 통화 기호와 같은 숫자 문자열의 요소는 모두 문화권마다 다릅니다. 구문 분석 메서드는 이러한 문화권별 차이를 인식하는 형식 공급자를 암시적으로 또는 명시적으로 사용합니다. Parse 또는 TryParse 메서드에 대한 호출에서 형식 공급자가 지정되어 있지 않으면 현재 스레드 문화권(NumberFormatInfo.CurrentInfo 속성으로 반환된 NumberFormatInfo 개체)과 연관된 형식 공급자가 사용됩니다.

형식 공급자는 IFormatProvider 구현으로 표현됩니다. 이 인터페이스에는 단일 매개 변수가 형식을 지정할 유형을 나타내는 Type 개체인 단일 멤버 GetFormat 메서드가 포함됩니다. 이 메서드는 서식 지정 정보를 제공하는 개체를 반환합니다. .NET Framework는 숫자 문자열의 구문 분석을 위해 다음 두 가지 IFormatProvider 구현을 지원합니다.

• CultureInfo.GetFormat 메서드가 문화권별 서식 지정 정보를 제공하는 NumberFormatInfo 개체를 반환하는 CultureInfo 개체

• NumberFormatInfo.GetFormat 메서드가 그 자체를 반환하는 NumberFormatInfo 개체

다음 예제에서는 배열의 각 문자열을 Double 값으로 변환하려고 시도합니다. 먼저 영어(미국) 문화권의 규칙이 반영된 형식 공급자를 사용하여 문자열을 구문 분석합니다. 이 작업이 FormatException을 throw하면 프랑스어(프랑스) 문화권의 규칙이 반영된 형식 공급자를 사용하여 문자열을 구문 분석합니다.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { "1,304.16", "$1,456.78", "1,094", "152", 
                                 "123,45 €", "1 304,16", "Ae9f" }
      Dim number As Double
      Dim culture As CultureInfo = Nothing

      For Each value As String In values
         Try
            culture = CultureInfo.CreateSpecificCulture("en-US")
            number = Double.Parse(value, culture)
            Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number)
         Catch e As FormatException
            Console.WriteLine("{0}: Unable to parse '{1}'.", 
                              culture.Name, value)
            culture = CultureInfo.CreateSpecificCulture("fr-FR")
            Try
               number = Double.Parse(value, culture)
               Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number)
            Catch ex As FormatException
               Console.WriteLine("{0}: Unable to parse '{1}'.", 
                                 culture.Name, value)
            End Try
         End Try
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    en-US: 1,304.16 --> 1304.16
'    
'    en-US: Unable to parse '$1,456.78'.
'    fr-FR: Unable to parse '$1,456.78'.
'    
'    en-US: 1,094 --> 1094
'    
'    en-US: 152 --> 152
'    
'    en-US: Unable to parse '123,45 €'.
'    fr-FR: Unable to parse '123,45 €'.
'    
'    en-US: Unable to parse '1 304,16'.
'    fr-FR: 1 304,16 --> 1304.16
'    
'    en-US: Unable to parse 'Ae9f'.
'    fr-FR: Unable to parse 'Ae9f'.
'    ' The example displays the following output:
'    en-US: 1,304.16 --> 1304.16
'    
'    en-US: Unable to parse '$1,456.78'.
'    fr-FR: Unable to parse '$1,456.78'.
'    
'    en-US: 1,094 --> 1094
'    
'    en-US: 152 --> 152
'    
'    en-US: Unable to parse '123,45 €'.
'    fr-FR: Unable to parse '123,45 €'.
'    
'    en-US: Unable to parse '1 304,16'.
'    fr-FR: 1 304,16 --> 1304.16
'    
'    en-US: Unable to parse 'Ae9f'.
'    fr-FR: Unable to parse 'Ae9f'.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { "1,304.16", "$1,456.78", "1,094", "152", 
                          "123,45 €", "1 304,16", "Ae9f" };
      double number;
      CultureInfo culture = null;

      foreach (string value in values) {
         try {
            culture = CultureInfo.CreateSpecificCulture("en-US");
            number = Double.Parse(value, culture);
            Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number);
         }   
         catch (FormatException) {
            Console.WriteLine("{0}: Unable to parse '{1}'.", 
                              culture.Name, value);
            culture = CultureInfo.CreateSpecificCulture("fr-FR");
            try {
               number = Double.Parse(value, culture);
               Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number);
            }
            catch (FormatException) {
               Console.WriteLine("{0}: Unable to parse '{1}'.", 
                                 culture.Name, value);
            }
         }
         Console.WriteLine();
      }   
   }
}
// The example displays the following output:
//    en-US: 1,304.16 --> 1304.16
//    
//    en-US: Unable to parse '$1,456.78'.
//    fr-FR: Unable to parse '$1,456.78'.
//    
//    en-US: 1,094 --> 1094
//    
//    en-US: 152 --> 152
//    
//    en-US: Unable to parse '123,45 €'.
//    fr-FR: Unable to parse '123,45 €'.
//    
//    en-US: Unable to parse '1 304,16'.
//    fr-FR: 1 304,16 --> 1304.16
//    
//    en-US: Unable to parse 'Ae9f'.
//    fr-FR: Unable to parse 'Ae9f'.

구문 분석 및 NumberStyles 값

구문 분석 작업으로 처리할 수 있는 스타일 요소(예: 공백, 그룹 구분 기호, 소수 구분 기호)는 NumberStyles 열거형 값으로 정의됩니다. 기본적으로 정수 값을 나타내는 문자열은 숫자, 선행 및 후행 공백, 선행 부호만 허용되는 NumberStyles.Integer 값을 사용하여 구문 분석됩니다. 부동 소수 값을 나타내는 문자열은 NumberStyles.Float 및 NumberStyles.AllowThousands 값의 조합을 사용하여 구문 분석됩니다. 이 조합 스타일은 선행 및 후행 공백, 선행 부호, 소수 구분 기호, 그룹 구분 기호 및 지수와 함께 10진수를 표시할 수 있도록 허용합니다. NumberStyles 형식의 매개 변수를 포함하는 Parse 또는 TryParse 메서드의 오버로드를 호출하고 하나 이상의 NumberStyles 플래그를 설정하면 구문 분석 작업을 성공하기 위해 문자열에 제공할 수 있는 스타일 요소를 제어할 수 있습니다.

예를 들어 그룹 구분 기호를 포함하는 문자열은 Int32.Parse(String) 메서드를 사용하여 Int32 값으로 변환할 수 없지만, 다음 예제에서 설명하는 것처럼 NumberStyles.AllowThousands 플래그를 사용할 경우 변환이 성공합니다.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As String = "1,304"
      Dim number As Integer
      Dim provider As IFormatProvider = CultureInfo.CreateSpecificCulture("en-US")
      If Int32.TryParse(value, number) Then
         Console.WriteLine("{0} --> {1}", value, number)
      Else
         Console.WriteLine("Unable to convert '{0}'", value)
      End If

      If Int32.TryParse(value, NumberStyles.Integer Or NumberStyles.AllowThousands, 
                        provider, number) Then
         Console.WriteLine("{0} --> {1}", value, number)
      Else
         Console.WriteLine("Unable to convert '{0}'", value)
      End If
   End Sub
End Module
' The example displays the following output:
'       Unable to convert '1,304'
'       1,304 --> 1304

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string value = "1,304";
      int number;
      IFormatProvider provider = CultureInfo.CreateSpecificCulture("en-US");
      if (Int32.TryParse(value, out number))
         Console.WriteLine("{0} --> {1}", value, number);
      else
         Console.WriteLine("Unable to convert '{0}'", value);

      if (Int32.TryParse(value, NumberStyles.Integer | NumberStyles.AllowThousands, 
                        provider, out number))
         Console.WriteLine("{0} --> {1}", value, number);
      else
         Console.WriteLine("Unable to convert '{0}'", value);
   }
}
// The example displays the following output:
//       Unable to convert '1,304'
//       1,304 --> 1304

주의
구문 분석 작업에는 항상 특정 문화권의 서식 지정 규칙이 사용됩니다.CultureInfo 또는 NumberFormatInfo 개체를 전달하는 방법으로 문화권을 지정하지 않으면 현재 스레드와 연결된 문화권이 사용됩니다.

다음 표에서는 NumberStyles 열거형의 멤버를 나열하고 이러한 멤버가 구문 분석 작업에 미치는 영향에 대해 설명합니다.

또한 NumberStyles 열거형은 여러 NumberStyles 플래그를 포함하는 다음과 같은 복합 스타일을 제공합니다.

구문 분석 및 유니코드 숫자

유니코드 표준은 여러 문자 환경에서 숫자에 대한 코드 포인트를 정의합니다. 예를 들어 U+0030에서 U+0039의 코드 포인트는 기본 라틴어 숫자 0부터 9까지를 나타내며, U+09E6에서 U+09EF의 코드 포인트는 벵골어 숫자 0부터 9까지, U+FF10에서 U+FF19의 코드 포인트는 전자 숫자 0부터 9까지를 나타냅니다. 하지만 구문 분석 메서드에서 인식되는 유일한 숫자는 코드 포인트 U+0030에서 U+0039의 기본 라틴어 숫자 0-9가지입니다. 숫자 구문 분석 메서드에 다른 숫자가 포함된 문자열이 전달되면 메서드가 FormatException을 throw합니다.

다음 예제에서는 다른 문자 환경의 숫자로 구성되는 문자열을 구문 분석하기 위해 Int32.Parse 메서드를 사용합니다. 이 예제의 결과에서와 같이 기본 라틴어 숫자에 대한 구문 분석 시도는 성공하지만 전자, 아랍어-인도어, 벵골어 숫자에 대한 구문 분석 시도는 실패합니다.

Module Example
   Public Sub Main()
      Dim value As String
      ' Define a string of basic Latin digits 1-5.
      value = ChrW(&h31) + ChrW(&h32) + ChrW(&h33) + ChrW(&h34) + ChrW(&h35)
      ParseDigits(value)

      ' Define a string of Fullwidth digits 1-5.
      value = ChrW(&hff11) + ChrW(&hff12) + ChrW(&hff13) + ChrW(&hff14) + ChrW(&hff15)
      ParseDigits(value)

      ' Define a string of Arabic-Indic digits 1-5.
      value = ChrW(&h661) + ChrW(&h662) + ChrW(&h663) + ChrW(&h664) + ChrW(&h665)
      ParseDigits(value)

      ' Define a string of Bengali digits 1-5.
      value = ChrW(&h09e7) + ChrW(&h09e8) + ChrW(&h09e9) + ChrW(&h09ea) + ChrW(&h09eb)
      ParseDigits(value)
   End Sub

   Sub ParseDigits(value As String)
      Try
         Dim number As Integer = Int32.Parse(value)
         Console.WriteLine("'{0}' --> {1}", value, number)
      Catch e As FormatException
         Console.WriteLine("Unable to parse '{0}'.", value)      
      End Try     
   End Sub
End Module
' The example displays the following output:
'       '12345' --> 12345
'       Unable to parse '１２３４５'.
'       Unable to parse '١٢٣٤٥'.
'       Unable to parse '১২৩৪৫'.

using System;

public class Example
{
   public static void Main()
   {
      string value;
      // Define a string of basic Latin digits 1-5.
      value = "\u0031\u0032\u0033\u0034\u0035";
      ParseDigits(value);

      // Define a string of Fullwidth digits 1-5.
      value = "\uFF11\uFF12\uFF13\uFF14\uFF15";
      ParseDigits(value);

      // Define a string of Arabic-Indic digits 1-5.
      value = "\u0661\u0662\u0663\u0664\u0665";
      ParseDigits(value);

      // Define a string of Bengali digits 1-5.
      value = "\u09e7\u09e8\u09e9\u09ea\u09eb";
      ParseDigits(value);
   }

   static void ParseDigits(string value)
   {
      try {
         int number = Int32.Parse(value);
         Console.WriteLine("'{0}' --> {1}", value, number);
      }   
      catch (FormatException) {
         Console.WriteLine("Unable to parse '{0}'.", value);      
      }     
   }
}
// The example displays the following output:
//       '12345' --> 12345
//       Unable to parse '１２３４５'.
//       Unable to parse '١٢٣٤٥'.
//       Unable to parse '১২৩৪৫'.

참고 항목

참조

NumberStyles

개념

형식 서식 지정

기타 리소스

문자열 구문 분석

변경 기록