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

IndexOf的語法

C#中IndexOf的基本語法相當簡單。 該方法有多個重載，允許靈活地設置搜索參數，包括能夠指定搜索的起始點和要檢查的字符數量。

最簡單的形式是public int IndexOf(char value)，用於搜索單個字符。 還有一個public int IndexOf(string value)用於搜索子字符串。 進階版本允許指定開始索引或同時指定開始索引和計數，增強該方法在搜索操作中的多樣性。

使用IndexOf

為了說明IndexOf的使用，考慮一個場景，在這裡您需要找到字符或子字符串在較大字符串中的位置。 這裡有一個簡單的例子：

public static void Main(string[] args)
{
    string str = "Hello, world!";
    int index = str.IndexOf('o');
    Console.WriteLine("The index of 'o' is: " + index);
}

public static void Main(string[] args)
{
    string str = "Hello, world!";
    int index = str.IndexOf('o');
    Console.WriteLine("The index of 'o' is: " + index);
}

依據此例，該代碼段定位字符'o'的首次出現，顯示以下輸出來顯示其位置。 輸出將是：

'o'的索引是：4

請注意，索引是零基的，這意味著第一個字符串字符從索引0開始。

指定起始索引

C#中的string IndexOf方法是字符串操作的核心工具，擅長定位另一個字符串中的指定字符或子字符串。 這特別有用於當您有興趣找到字符或子字符串的後續出現時。 例如：

string value = "Brown fox jumps over";
int startIndex = value.IndexOf('o') + 1;
int index = value.IndexOf('o', startIndex);
Console.WriteLine("The index of the second 'o' is: " + index);

string value = "Brown fox jumps over";
int startIndex = value.IndexOf('o') + 1;
int index = value.IndexOf('o', startIndex);
Console.WriteLine("The index of the second 'o' is: " + index);

首先，該代碼找到首次出現的'o'，然後從發現的第一個索引之後搜索下一個'o'。

當代碼運行時，控制台輸出：

第二個'o'的索引是7

使用起始索引和計數進行搜索

更詳細的查詢涉及同時指定起始索引和計數，如以下示例所示，以優化搜索。 這將搜索限制在字符串中的特定範圍內，優化性能和精度。 操作如下：

string sample = "Sample text for testing";
int startindex = 7;
int count = 10;
int result = sample.IndexOf("text", startindex, count);
Console.WriteLine("Index of 'text': " + result);

string sample = "Sample text for testing";
int startindex = 7;
int count = 10;
int result = sample.IndexOf("text", startindex, count);
Console.WriteLine("Index of 'text': " + result);

此代碼段在指定範圍內搜索單詞"text"，展示了該方法在大型字符串中縮小搜索範圍的靈活性。

當此代碼運行時，控制台輸出：

'text'的索引是：7

搜索不存在的元素

一個常見的情形是試圖在字符串中找到不存在的字符或子字符串。 在這些情況下，該方法返回-1作為結果值，以表示搜索的結果。 這是一種應驗證以避免代碼錯誤的重要條件。 操作如下：

string phrase = "Searching for a missing character";
int index = phrase.IndexOf('x'); // 'x' does not exist in the string
if (index == -1)
{
    Console.WriteLine("未找到字符。");
}
else
{
    Console.WriteLine("Character found at index: " + index);
}

string phrase = "Searching for a missing character";
int index = phrase.IndexOf('x'); // 'x' does not exist in the string
if (index == -1)
{
    Console.WriteLine("未找到字符。");
}
else
{
    Console.WriteLine("Character found at index: " + index);
}

當此代碼運行時，控制台輸出：

未找到字符。

處理空字串

另一特殊情況是當搜索字符串或目標字符串為空時。 IndexOf認為任何字符串的開頭（即便是空的）是空子字串的有效位置。 因此，在任何字符串中搜索空字符串將返回0，表示字符串的開始。 相反，在空字符串中搜索任何非空子字符串將返回-1，因為沒有可能的匹配。 理解這一行為對於獲得準確的搜索結果至關重要。

大小寫敏感性和文化考量

默認情況下，IndexOf方法是大小寫敏感的。這意味著搜索'a'與搜索'A'是不同的。 根據應用的要求，您可能需要進行不區分大小寫的搜索。 這可以通過使用接受StringComparison枚舉作為參數的IndexOf方法來實現。 此外，IndexOf尊重字符串比較的文化規則，這可能會影響Unicode字符的搜索結果。 對於具有特定文化或語言需求的應用，這種行為可以通過接受CultureInfo對象的重載調整。

範例：不區分大小寫的搜索

string data = "Case-Insensitive Search Example";
int indexInsensitive = data.IndexOf("search", StringComparison.OrdinalIgnoreCase);
if (indexInsensitive >= 0)
{
    Console.WriteLine("Substring found at index: " + indexInsensitive);
}
else
{
    Console.WriteLine("Substring not found.");
}

string data = "Case-Insensitive Search Example";
int indexInsensitive = data.IndexOf("search", StringComparison.OrdinalIgnoreCase);
if (indexInsensitive >= 0)
{
    Console.WriteLine("Substring found at index: " + indexInsensitive);
}
else
{
    Console.WriteLine("Substring not found.");
}

此代碼段展示如何進行不區分大小寫的搜索，確保大寫變化不影響定位字符串內的子字符串的能力。

代碼示例

請確保在專案中安裝了IronPDF以使用此示例。 若沒有，您可以通過NuGet包管理器使用以下指令輕鬆添加：

Install-Package IronPdf

要將IronPDF的功能與C#中的IndexOf操作一起整合，您通常會考慮一個情況，即您有興趣在PDF文件中查找特定文本，然後可能對該文本進行操作或交互。

以下範例是概念性的，專注於從PDF中提取文本，然後使用IndexOf方法找到該文本中特定子字符串的位置。 請記住，IronPDF的API可能不會直接公開名為IndexOf的方法，因為這是C#中string類的方法。

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of the IronPDF PDF document reader
        var pdfDocument = PdfDocument.FromFile("path/to/your/document.pdf");
        // Extract all text from the PDF document
        var allText = pdfDocument.ExtractAllText();
        // The text you want to search for in the PDF document
        string searchText = "specific text";
        // Use IndexOf to find the position of searchText in the extracted text
        int position = allText.IndexOf(searchText);
        if (position != -1)
        {
            Console.WriteLine($"Text found at position: {position}");
            // You can perform further operations here, such as highlighting the text in the PDF if supported by IronPDF
        }
        else
        {
            Console.WriteLine("Text not found in the PDF document.");
        }
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of the IronPDF PDF document reader
        var pdfDocument = PdfDocument.FromFile("path/to/your/document.pdf");
        // Extract all text from the PDF document
        var allText = pdfDocument.ExtractAllText();
        // The text you want to search for in the PDF document
        string searchText = "specific text";
        // Use IndexOf to find the position of searchText in the extracted text
        int position = allText.IndexOf(searchText);
        if (position != -1)
        {
            Console.WriteLine($"Text found at position: {position}");
            // You can perform further operations here, such as highlighting the text in the PDF if supported by IronPDF
        }
        else
        {
            Console.WriteLine("Text not found in the PDF document.");
        }
    }
}

此代碼段為打開PDF、提取其文本內容和在該內容中搜索特定字符串提供了一個基本框架。

當此代碼運行時，控制台輸出：文本定位於：1046