C# Substring (Comment ça fonctionne pour les développeurs)

Syntaxe et Paramètres

La méthode Substring a deux formes principales :

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) : Cela récupère une sous-chaîne qui commence à partir de startIndex et continue jusqu'à la fin de la chaîne.
2. public string Substring(int startIndex, int length) : Cela récupère une sous-chaîne commençant à startIndex et de la longueur spécifiée.

Les paramètres impliqués sont :

• int startIndex : C'est l'index basé sur zéro à partir duquel la sous-chaîne commence.
• int length : (optionnel) C'est le deuxième paramètre. C'est le nombre de caractères à inclure dans la sous-chaîne retournée.

Comment Fonctionne la Méthode Substring

Le processus de la méthode Substring est simple. Lorsqu'elle est appelée, elle extrait les caractères de la chaîne originale en commençant à l'index donné (startIndex). Si le paramètre length est fourni, la méthode retourne le nombre de caractères spécifié. Sans le paramètre length, elle continue jusqu'à la fin de la chaîne. L'utilisation de Substring en C# garantit que les deux paramètres (startIndex et length) sont traités comme des entiers, assurant la sécurité du type et évitant les erreurs potentielles à l'exécution.

Extraction jusqu'à la Fin de la Chaîne

Supposons que vous ayez une chaîne et que vous deviez extraire une sous-chaîne d'un index particulier jusqu'à la fin de la chaîne. Voici comment vous pourriez le faire :

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, world!";
    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, world!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

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

Sortie :

world!

Dans cet exemple, la méthode Substring commence à l'index 7, ce qui correspond au 'w' dans "world!", et récupère chaque caractère jusqu'à la fin de la chaîne. Ceci est particulièrement utile lorsque la longueur de la sous-chaîne est dynamique ou non prédéterminée.

Extraction d'une Sous-chaîne avec Longueur Spécifiée

Voyons maintenant un scénario où à la fois l'index de début et la longueur de la sous-chaîne sont spécifiés :

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, world!";
    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, world!";
    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 Shared Sub Main(ByVal args() As String)
	Dim text As String = "Hello, world!"
	Dim substring As String = text.Substring(7, 5) ' Starts at index 7, length of 5
	Console.WriteLine(substring)
End Sub

Sortie :

world

Ici, la sous-chaîne commence au septième caractère et s'étend sur cinq caractères. Cette méthode est très utile lorsque vous avez besoin d'un contrôle précis sur les limites de la sous-chaîne.

Récupération de Sous-chaînes à partir d'un Tableau de Chaînes de Caractères

Supposons que vous ayez un tableau de chaînes de caractères et que vous souhaitiez extraire des sous-chaînes de chaque chaîne en fonction d'une position de caractère spécifiée et d'une longueur. Vous pouvez utiliser une boucle foreach pour itérer sur le tableau et appliquer la méthode Substring à chaque chaîne.

// 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

Ce code affichera :

ppl
ana
ran

Vérification de la Validité des Indices

Pour s'assurer que votre extraction de sous-chaîne ne cause pas d'erreur, vous pouvez ajouter des vérifications :

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, world!";
    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, world!";
    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 Shared Sub Main(ByVal args() As String)
	Dim text As String = "Hello, world!"
	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

Ce bloc de code assure que les paramètres de la sous-chaîne sont valides avant de tenter d'extraire la sous-chaîne, évitant ainsi les erreurs potentielles à l'exécution.

Exemple de Code : Générer un PDF à partir d'une Chaîne Extraite

Considérons un scénario où vous avez un grand texte contenant des informations importantes à des indices spécifiés et que vous devez extraire ces informations et générer un fichier PDF avec. Voici un exemple étape par étape de la façon dont cela peut être réalisé en utilisant à la fois IronPDF et la méthode C# Substring.

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

Ce processus démontre une manière simple d'intégrer la manipulation de texte et la création de PDF, ce qui peut être particulièrement utile pour générer des rapports ou de la documentation nécessitant l'extraction et la présentation d'informations spécifiques à partir de textes plus longs.