Analýza číselných řetězců v .NET

  • Článek

Všechny číselné typy mají dvě statické metody analýzy a ParseTryParse, které můžete použít k převodu řetězcové reprezentace čísla na číselný typ. Tyto metody umožňují analyzovat řetězce vytvořené pomocí formátových řetězců zdokumentovaných v řetězcích standardního číselného formátu a vlastních řetězců číselného formátu. Ve výchozím nastavení Parse mohou metody TryParse úspěšně převést řetězce obsahující celočíselné desetinné číslice pouze na celočíselné hodnoty. Mohou úspěšně převést řetězce, které obsahují celočíselné a desetinné číslice, oddělovače skupin a oddělovač desetinných míst na hodnoty s plovoucí desetinnou čárkou. Metoda Parse vyvolá výjimku, pokud operace selže, zatímco TryParse metoda vrátí false.

Poznámka:

Počínaje rozhraním .NET 7 implementují System.IParsable<TSelf> také číselné typy v .NET, které definují IParsable<TSelf>.Parse a IParsable<TSelf>.TryParse metody.

Analýza a formátování zprostředkovatelů

Řetězcové znázornění číselných hodnot se obvykle liší podle jazykové verze. Prvky číselných řetězců, jako jsou symboly měny, oddělovače skupin (nebo tisíců) a oddělovače desetinných míst, se liší podle jazykové verze. Metody analýzy buď implicitně, nebo explicitně používají poskytovatele formátu, který rozpoznává tyto varianty specifické pro jazykovou verzi. Pokud není v volání metody nebo TryParse volání Parse zadán žádný zprostředkovatel formátu, použije se zprostředkovatel formátu přidružený k aktuální jazykové verzi (NumberFormatInfoobjekt vrácený NumberFormatInfo.CurrentInfo vlastností).

Zprostředkovatel formátu je reprezentován implementací IFormatProvider . Toto rozhraní má jeden člen, metodu GetFormat , jejíž jediný parametr je Type objekt, který představuje typ, který má být formátován. Tato metoda vrátí objekt, který poskytuje informace o formátování. .NET podporuje následující dvě IFormatProvider implementace pro analýzu číselných řetězců:

Následující příklad se pokusí převést každý řetězec v poli na Double hodnotu. Nejprve se pokusí analyzovat řetězec pomocí zprostředkovatele formátu, který odráží konvence jazykové verze angličtiny (USA). Pokud tato operace vyvolá FormatExceptionchybu , pokusí se analyzovat řetězec pomocí zprostředkovatele formátu, který odráží konvence francouzské jazykové verze (Francie).

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'.

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'.

Analýza a hodnoty NumberStyles

Prvky stylu (například prázdné znaky, oddělovače skupin a oddělovač desetinných míst), které může operace analýzy zpracovat, jsou definovány hodnotou výčtu NumberStyles . Ve výchozím nastavení se řetězce, které představují celočíselné hodnoty, parsují pomocí NumberStyles.Integer hodnoty, což umožňuje pouze číselné číslice, počáteční a koncové prázdné znaky a počáteční znaménko. Řetězce, které představují hodnoty s plovoucí desetinnou čárkou, se parsují pomocí kombinace NumberStyles.Float hodnot a NumberStyles.AllowThousands hodnot. Tento složený styl umožňuje desetinné číslice spolu s počátečními a koncovými prázdnými znaky, počátečním symbolem, oddělovačem desetinných míst, oddělovačem skupin a exponentem. Voláním přetížení Parse nebo TryParse metody, která obsahuje parametr typu NumberStyles a nastavením jednoho nebo více NumberStyles příznaků, můžete řídit prvky stylu, které mohou být přítomné v řetězci, aby operace analýzy byla úspěšná.

Například řetězec, který obsahuje oddělovač skupin, nelze pomocí metody převést na Int32 hodnotu Int32.Parse(String) . Převod však proběhne úspěšně, pokud použijete NumberStyles.AllowThousands příznak, jak je znázorněno v následujícím příkladu.

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

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

Upozorňující

Operace analýzy vždy používá konvence formátování konkrétní jazykové verze. Pokud nezadáte jazykovou verzi předáním objektu CultureInfo nebo objektu NumberFormatInfo , použije se jazyková verze přidružená k aktuálnímu vláknu.

Následující tabulka uvádí členy NumberStyles výčtu a popisuje účinek, který mají na operaci analýzy.

Hodnota NumberStyles Vliv na řetězec, který se má analyzovat
NumberStyles.None Jsou povoleny pouze číselné číslice.
NumberStyles.AllowDecimalPoint Jsou povoleny oddělovače desetinných míst a desetinné číslice. Pro celočíselné hodnoty je povolená pouze nula jako desetinná číslice. Platné oddělovače desetinných míst jsou určeny vlastnostíNumberFormatInfo.NumberDecimalSeparator.NumberFormatInfo.CurrencyDecimalSeparator
NumberStyles.AllowExponent Znak "e" nebo "E" lze použít k označení exponenciální notace. Další informace najdete na webu NumberStyles.
NumberStyles.AllowLeadingWhite Jsou povoleny úvodní prázdné znaky.
NumberStyles.AllowTrailingWhite Koncové prázdné znaky jsou povolené.
NumberStyles.AllowLeadingSign Kladné nebo záporné znaménko může předcházet číselným číslicům.
NumberStyles.AllowTrailingSign Kladné nebo záporné znaménko může následovat za číselnými číslicemi.
NumberStyles.AllowParentheses Závorky lze použít k označení záporných hodnot.
NumberStyles.AllowThousands Oddělovač skupin je povolen. Znak oddělovače skupin je určen NumberFormatInfo.NumberGroupSeparator vlastností.NumberFormatInfo.CurrencyGroupSeparator
NumberStyles.AllowCurrencySymbol Symbol měny je povolen. Symbol měny je definován vlastností NumberFormatInfo.CurrencySymbol .
NumberStyles.AllowHexSpecifier Řetězec, který se má analyzovat, se interpretuje jako šestnáctkové číslo. Může obsahovat šestnáctkové číslice 0-9, A-F a a-f. Tento příznak lze použít pouze k analýze celočíselné hodnoty.

Kromě toho poskytuje NumberStyles výčet následující složené styly, které obsahují více NumberStyles příznaků.

Složená hodnota NumberStyles Zahrnuje členy.
NumberStyles.Integer Zahrnuje , NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhitea NumberStyles.AllowLeadingSign styly. Toto je výchozí styl, který se používá k analýze celočíselné hodnoty.
NumberStyles.Number Zahrnuje styly NumberStyles.AllowLeadingWhite, , NumberStyles.AllowTrailingWhite, NumberStyles.AllowDecimalPointNumberStyles.AllowLeadingSignNumberStyles.AllowTrailingSigna NumberStyles.AllowThousands styly.
NumberStyles.Float Zahrnuje styly NumberStyles.AllowLeadingWhite, , NumberStyles.AllowDecimalPointNumberStyles.AllowTrailingWhiteNumberStyles.AllowLeadingSign, a NumberStyles.AllowExponent styly.
NumberStyles.Currency Zahrnuje všechny styly kromě NumberStyles.AllowExponent a NumberStyles.AllowHexSpecifier.
NumberStyles.Any Obsahuje všechny styly kromě NumberStyles.AllowHexSpecifier.
NumberStyles.HexNumber Zahrnuje , NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhitea NumberStyles.AllowHexSpecifier styly.

Analýza a číslice v kódování Unicode

Standard Unicode definuje body kódu pro číslice v různých systémech zápisu. Například body kódu od U+0030 do U+0039 představují základní latinky číslice 0 až 9, body kódu z U+09E6 na U+09EF představují číslice Bangla 0 až 9 a kódové body z U+FF10 až U+FF19 představují číslice Fullwidth 0 až 9. Jedinými číselnými číslicemi rozpoznanými metodami analýzy jsou však základní číslice latinky 0-9 s kódovými body od U+0030 do U+0039. Pokud je číselná metoda analýzy předána řetězec, který obsahuje jakékoli jiné číslice, metoda vyvolá FormatException.

Následující příklad používá metodu Int32.Parse k analýze řetězců, které se skládají z číslic v různých systémech zápisu. Jak ukazuje výstup z příkladu, pokus o parsování základních latinkových číslic proběhne úspěšně, ale pokus o parsování číslic Fullwidth, Arabic-Indic a Bangla selže.

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 Bangla 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 '১২৩৪৫'.

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 Bangla 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 '১২৩৪৫'.

Viz také