Substring em C# (Como funciona para desenvolvedores)

Sintaxe e Parâmetros

O método Substring possui duas formas principais:

public string Substring(int startIndex);
public string Substring(int startIndex, int length);

public string Substring(int startIndex);
public string Substring(int startIndex, int length);

public String Substring(Integer startIndex)
public String Substring(Integer startIndex, Integer length)

1. public string Substring(int startIndex): Este método recupera uma substring que começa no índice startIndex e continua até o final da string.
2. public string Substring(int startIndex, int length): Esta função recupera uma substring começando em startIndex e com o comprimento especificado.

Os parâmetros envolvidos são:

• int startIndex: Este é o índice baseado em zero a partir do qual a substring começa.
• int length: (opcional) É o segundo parâmetro. Este é o número de caracteres a serem incluídos na substring retornada.

Como funciona o método Substring

O processo do método Substring é simples. Quando chamada, ela extrai caracteres da string original a partir do índice fornecido ( startIndex ). Se o parâmetro de comprimento for fornecido, o método retorna o número de caracteres especificado. Sem o parâmetro de comprimento , a string continua até o final. O uso de Substring em C# garante que ambos os parâmetros (startIndex e length) sejam tratados como inteiros, reforçando a segurança de tipos e prevenindo possíveis erros em tempo de execução.

Extraindo até o final da string

Suponha que você tenha uma string e precise extrair uma substring de um índice específico até o final da string. Eis como você pode fazer isso:

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, mundo!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, mundo!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

Option Strict On



Public Module Program
    ' Main method demonstrating substring extraction
    Public Sub Main(args As String())
        Dim text As String = "Hello, mundo!"
        Dim substring As String = text.Substring(7) ' Extract from index 7 to the end
        Console.WriteLine(substring)
    End Sub
End Module

Saída:

mundo!

Neste exemplo, o método Substring começa no índice 7, que corresponde ao 'w' em "mundo!", e recupera todos os caracteres até o final da string. Isso é particularmente útil quando o comprimento da subcadeia é dinâmico ou não predeterminado.

Extraindo uma substring com comprimento especificado

Agora, vejamos um cenário em que tanto o índice inicial quanto o comprimento da substring são especificados:

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, mundo!";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, mundo!";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

Option Strict On



Public Module Program
    ' Main method demonstrating substring extraction with specified length
    Public Sub Main(args As String())
        Dim text As String = "Hello, mundo!"
        Dim substring As String = text.Substring(7, 5) ' Starts at index 7, length of 5
        Console.WriteLine(substring)
    End Sub
End Module

Saída:

mundo

Aqui, a subcadeia começa no sétimo caractere e tem cinco caracteres de comprimento. Este método é muito útil quando você precisa de controle preciso sobre os limites da substring.

Recuperando substrings de um array de strings

Suponha que você tenha uma matriz de strings e queira extrair substrings de cada string com base em uma posição e comprimento de caractere específicos. Você pode usar um loop foreach para iterar sobre o array e aplicar o método Substring a cada string.

// Example of extracting substrings from an array of strings
string[] array = { "apple", "banana", "orange" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

// Example of extracting substrings from an array of strings
string[] array = { "apple", "banana", "orange" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

' Example of extracting substrings from an array of strings
Dim array() As String = { "apple", "banana", "orange" }
For Each str As String In array
	Dim substring As String = str.Substring(1, 3) ' Substring starts from index 1
	Console.WriteLine(substring)
Next str

Este código produzirá a seguinte saída:

ppl
ana
ran

Verificação da validade dos índices

Para garantir que a extração da substring não cause erros, você pode adicionar verificações:

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, mundo!";
    int startIndex = 7;
    int length = 5;
    if (startIndex >= 0 && startIndex < text.Length && startIndex + length <= text.Length)
    {
        string substring = text.Substring(startIndex, length);
        Console.WriteLine(substring);
    }
    else
    {
        Console.WriteLine("Invalid substring parameters.");
    }
}

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, mundo!";
    int startIndex = 7;
    int length = 5;
    if (startIndex >= 0 && startIndex < text.Length && startIndex + length <= text.Length)
    {
        string substring = text.Substring(startIndex, length);
        Console.WriteLine(substring);
    }
    else
    {
        Console.WriteLine("Invalid substring parameters.");
    }
}

Option Strict On



Public Module Program
    ' Main method with checks to avoid ArgumentOutOfRangeException
    Public Sub Main(args As String())
        Dim text As String = "Hello, mundo!"
        Dim startIndex As Integer = 7
        Dim length As Integer = 5
        If startIndex >= 0 AndAlso startIndex < text.Length AndAlso startIndex + length <= text.Length Then
            Dim substring As String = text.Substring(startIndex, length)
            Console.WriteLine(substring)
        Else
            Console.WriteLine("Invalid substring parameters.")
        End If
    End Sub
End Module

Este bloco de código garante que os parâmetros da substring sejam válidos antes de tentar extrair a substring, evitando assim possíveis erros de tempo de execução.

Exemplo de código: Gerando um PDF a partir de uma string extraída

Vamos considerar um cenário em que você tem um texto extenso contendo informações importantes em índices específicos e precisa extrair essas informações e gerar um arquivo PDF com elas. A seguir, um exemplo passo a passo de como isso pode ser feito usando o IronPDF e o método Substring do C#.

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // Applying your license for IronPDF
        License.LicenseKey = "License-Key";
        // Original large text from which we need to extract information
        string originalText = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site.";
        // Using the Substring method to extract the part of the string that talks about IronPDF
        string importantInfo = originalText.Substring(0, 65);  // Extracts the first sentence

        // Create a PDF document with IronPDF
        var renderer = new ChromePdfRenderer();
        // Convert the extracted text to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>");
        // Save the PDF to a file
        pdf.SaveAs("ExtractedInfo.pdf");
        // Confirmation output
        Console.WriteLine("PDF generated successfully with extracted information.");
    }
}

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // Applying your license for IronPDF
        License.LicenseKey = "License-Key";
        // Original large text from which we need to extract information
        string originalText = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site.";
        // Using the Substring method to extract the part of the string that talks about IronPDF
        string importantInfo = originalText.Substring(0, 65);  // Extracts the first sentence

        // Create a PDF document with IronPDF
        var renderer = new ChromePdfRenderer();
        // Convert the extracted text to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>");
        // Save the PDF to a file
        pdf.SaveAs("ExtractedInfo.pdf");
        // Confirmation output
        Console.WriteLine("PDF generated successfully with extracted information.");
    }
}

Imports IronPdf
Imports System

Public Class PdfGenerator
	Public Shared Sub Main(ByVal args() As String)
		' Applying your license for IronPDF
		License.LicenseKey = "License-Key"
		' Original large text from which we need to extract information
		Dim originalText As String = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site."
		' Using the Substring method to extract the part of the string that talks about IronPDF
		Dim importantInfo As String = originalText.Substring(0, 65) ' Extracts the first sentence

		' Create a PDF document with IronPDF
		Dim renderer = New ChromePdfRenderer()
		' Convert the extracted text to PDF
		Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>")
		' Save the PDF to a file
		pdf.SaveAs("ExtractedInfo.pdf")
		' Confirmation output
		Console.WriteLine("PDF generated successfully with extracted information.")
	End Sub
End Class

Este processo demonstra uma forma simples de integrar a manipulação de texto e a criação de PDFs, o que pode ser particularmente útil para gerar relatórios ou documentação que exigem a extração e apresentação de informações específicas de textos mais extensos.