Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Int32.Parse — převod textu na int

Int32.Parse převádí číselný text na int. Seznamte se s výchozími pravidly formátu, vlivem jazykové oblasti na parsování a výjimkami způsobenými neplatným vstupem.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

Int32.Parse(string s)
Int32.Parse(string s, System.Globalization.NumberStyles style, IFormatProvider? provider)

Int32.Parse je statická metoda, která vrací int, tedy System.Int32. Zápis int.Parse volá stejnou metodu. Rozsah hodnot je od -2147483648 do 2147483647. Popsaná přetížení jsou dostupná v .NET 10 a nevyžadují žádné jazykové funkce preview.

Int32.Parse(string s) používá aktuální jazykovou oblast a NumberStyles.Integer: přijímá desetinné číslice, úvodní znaménko a bílé znaky na začátku nebo konci. Oddělovače skupin a desetinné oddělovače ve výchozím nastavení nepřijímá. Parametr style určuje povolené formáty, zatímco provider poskytuje kulturní konvence; null znamená aktuální jazykovou oblast. Pro předvídatelné parsování dat nezávislých na jazykové oblasti zadejte CultureInfo.InvariantCulture.

U přetížení pro řetězce způsobí null výjimku ArgumentNullException, neplatný formát způsobí FormatException a hodnota mimo rozsah způsobí OverflowException. Neplatné příznaky style způsobí ArgumentException. Pokud očekáváte neplatný vstup, zvolte Int32.TryParse, která signalizuje neúspěšný převod hodnotou false.

Příklad parsuje " +42 " a poté zachytí přetečení způsobené hodnotou "2147483648". Výslovně zadaná jazyková oblast zajišťuje předvídatelné parsování i výstup.

Příklady

using System;
using System.Globalization;

int value = Int32.Parse(" +42 ", NumberStyles.Integer, CultureInfo.InvariantCulture);
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));

try
{
    Int32.Parse("2147483648", NumberStyles.Integer, CultureInfo.InvariantCulture);
}
catch (OverflowException)
{
    Console.WriteLine("OverflowException");
}

Výsledek

42
OverflowException

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje