C# Substring (jak to działa dla programistów)

Składnia i parametry

Metoda Substring ma dwie podstawowe formy:

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): Pobiera podciąg, który zaczyna się od startIndex i trwa do końca ciągu.
2. public string Substring(int startIndex, int length): Pobiera podciąg zaczynający się od startIndex i o określonej długości.

Istotne parametry to:

• int startIndex: Jest to indeks zaczynający się od zera, od którego zaczyna się podciąg.
• int length: (opcjonalnie) Jest to drugi parametr. Jest to liczba znaków, które należy uwzględnić w zwracanym podciągu.

Jak działa metoda Substring

Działanie metody Substring jest proste. Po wywołaniu funkcja wyodrębnia znaki z oryginalnego ciągu znaków, zaczynając od podanego indeksu (startIndex). Jeśli podano parametr długości, metoda zwraca określoną liczbę znaków. Bez parametru długości tłumaczenie będzie kontynuowane do końca ciągu znaków. Użycie funkcji Substring w języku C# gwarantuje, że oba parametry (startIndex i length) są traktowane jako liczby całkowite, co zapewnia bezpieczeństwo typów i zapobiega potencjalnym błędom w czasie wykonywania.

Wyodrębnianie do końca ciągu znaków

Załóżmy, że masz ciąg znaków i chcesz wyodrębnić podciąg od określonego indeksu do końca ciągu. Oto jak można to zrobić:

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, świat!";
    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, świat!";
    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, świat!"
        Dim substring As String = text.Substring(7) ' Extract from index 7 to the end
        Console.WriteLine(substring)
    End Sub
End Module

Wynik:

świat!

W tym przykładzie metoda Substring rozpoczyna się od indeksu 7, który odpowiada literze "w" w słowie "świat!", i pobiera wszystkie znaki aż do końca ciągu. Jest to szczególnie przydatne, gdy długość podciągu jest dynamiczna lub nie jest z góry określona.

Wyodrębnianie podciągu o określonej długości

Przyjrzyjmy się teraz scenariuszowi, w którym określono zarówno indeks początkowy, jak i długość podciągu:

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

Wynik:

świat

W tym przypadku podciąg zaczyna się od siódmego znaku i ma długość pięciu znaków. Ta metoda jest bardzo przydatna, gdy potrzebna jest precyzyjna kontrola nad granicami podciągu.

Pobieranie podciągów z tablicy ciągów znaków

Załóżmy, że masz tablicę ciągów znaków i chcesz wyodrębnić podciągi z każdego ciągu na podstawie określonej pozycji znaku i długości. Można użyć pętli foreach do iteracji nad tablicą i zastosować metodę Substring do każdego ciągu znaków.

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

Ten kod wyświetli:

ppl
ana
ran

Sprawdzanie poprawności indeksów

Aby upewnić się, że wyodrębnianie podciągów nie powoduje błędu, można dodać sprawdzanie:

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, świat!";
    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, świat!";
    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, świat!"
        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

Ten blok kodu sprawdza poprawność parametrów podciągu przed próbą jego wyodrębnienia, co pozwala uniknąć potencjalnych błędów wykonania.

Przykład kodu: Generowanie pliku PDF na podstawie wyodrębnionego ciągu znaków

Rozważmy scenariusz, w którym masz duży tekst zawierający ważne informacje w określonych miejscach i musisz wyodrębnić te informacje oraz wygenerować z nich plik PDF. Poniżej znajduje się przykład krok po kroku, jak można to osiągnąć przy użyciu zarówno IronPDF, jak i metody Substring w języku 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

Proces ten pokazuje prosty sposób na połączenie edycji tekstu z tworzeniem plików PDF, co może być szczególnie przydatne przy generowaniu raportów lub dokumentacji wymagających wyodrębnienia i przedstawienia konkretnych informacji z większych tekstów.