C# Substring（對於開發者的運行原理）

語法和參數

Substring方法主要有兩種形式：

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

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

1. public string Substring(int startIndex):此函數檢索從startIndex開始到字串末尾的子字串。
2. public string Substring(int startIndex, int length ):此函數檢索從startIndex開始且長度為指定值的子字串。

涉及的參數有：

• int startIndex：這是子字串開始的從零開始的索引。
• int length:(可選)它是第二個參數。 這是要包含在返回子字串中的字元數。

Substring 方法的工作原理

Substring方法的操作過程很簡單。 呼叫時，它會從給定的索引( startIndex )開始從原始字串中提取字元。 如果提供了長度參數，則該方法傳回指定數量的字元。 如果沒有長度參數，它將一直處理到字串末尾。 在 C# 中使用Substring 函數可確保兩個參數(startIndex 和 length)都被視為整數，從而強制執行類型安全性並防止潛在的運行時錯誤。

提取到字串末尾

假設你有一個字串，你需要從特定索引提取到字串末尾的子字串。 以下是一種可行的方法：

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

輸出：

世界！

在這個例子中， Substring方法從索引 7 開始，對應於"世界！"中的"w"，並檢索字串末尾的每個字元。 當子字串的長度是動態的或未預先決定時，這種方法尤其有用。

提取指定長度的子字串

現在，讓我們來看一個同時指定起始索引和子字串長度的情況：

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, 世界！";
    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, 世界！";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

輸出：

世界

這裡，子字串從第七個字元開始，長度為五個字元。 當您需要精確控制子字串的邊界時，此方法非常有用。

從字串數組檢索子字串

假設你有一個字串數組，你想根據指定的字元位置和長度從每個字串中提取子字串。 您可以使用 foreach 迴圈遍歷數組，並將Substring方法套用到每個字串。

// Example of extracting substrings from an array of strings
string[] array = { "a人e", "b安娜na", "o跑ge" };
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 = { "a人e", "b安娜na", "o跑ge" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

這段程式碼將輸出：

人
安娜
跑

檢驗指標的有效性

為確保子字串提取不會導致錯誤，您可以新增以下檢查：

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

此程式碼區塊確保在嘗試提取子字串之前子字串參數有效，從而避免潛在的運行時錯誤。

程式碼範例：從提取的字串產生 PDF

假設有這樣一個場景：你有一篇很長的文本，其中包含指定索引處的重要信息，你需要提取這些信息並生成一個 PDF 文件。 以下將逐步示範如何使用IronPDF和 C# Substring方法來實現此目的。

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // A人ying 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 a人ications 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)
    {
        // A人ying 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 a人ications 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.");
    }
}

這個過程展示了一種將文字處理和 PDF 創建整合在一起的簡單方法，這對於產生需要從較大文字中提取和呈現特定資訊的報告或文件特別有用。