IndexOf C# (How It Works For Developers)

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 為基礎，也就是第一個字串字元從索引 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"一詞，展示此方法在縮小大字串搜尋範圍的彈性。

執行此程式碼時，控制台會輸出：

文字"索引： 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' 是不同的。 根據應用程式的需求，您可能需要執行不區分大小寫的搜尋。 這可以透過使用 IndexOf 方法來實現，該方法接受 StringComparison 枚舉作為參數。 此外，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 Package Manager 輕鬆新增：

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、擷取其文字內容，以及在該內容中搜尋特定字串的基本架構。

當執行此程式碼時，控制台會輸出：Text found at position：1046