CKTIS / C#
Int32.Parse — converter texto em int
Int32.Parse converte texto numérico em int. Conheça as regras de formato predefinidas, a influência da cultura na análise e as exceções causadas por entradas inválidas.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
Int32.Parse(string s)
Int32.Parse(string s, System.Globalization.NumberStyles style, IFormatProvider? provider)Int32.Parse é um método estático que devolve int, ou seja, System.Int32. Escrever int.Parse chama o mesmo método. O intervalo de valores vai de -2147483648 a 2147483647. As sobrecargas descritas estão disponíveis no .NET 10 e não requerem funcionalidades da linguagem preview.
Int32.Parse(string s) utiliza a cultura atual e NumberStyles.Integer: aceita algarismos decimais, um sinal inicial e espaços em branco no início ou no fim. Por predefinição, não aceita separadores de grupos nem separadores decimais. O parâmetro style determina os formatos permitidos, enquanto provider fornece as convenções culturais; null significa a cultura atual. Para analisar de forma previsível dados independentes da cultura, indique CultureInfo.InvariantCulture.
Nas sobrecargas que recebem cadeias de caracteres, null provoca ArgumentNullException, um formato inválido provoca FormatException e um valor fora do intervalo provoca OverflowException. Indicadores style inválidos provocam ArgumentException. Se forem esperadas entradas inválidas, escolha Int32.TryParse, que assinala uma conversão falhada com false.
O exemplo analisa " +42 " e, em seguida, interceta a exceção OverflowException lançada ao tentar converter "2147483648", cujo valor excede o limite máximo de int. Indicar explicitamente a cultura torna previsíveis tanto a análise como a saída.
Exemplos
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");
}Resultado
42 OverflowException
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.