IndexOf w języku C# (jak to działa dla programistów)

Składnia funkcji IndexOf

Podstawowa składnia funkcji IndexOf w języku C# jest dość prosta. Metoda ta ma kilka przeciążeń, co pozwala na elastyczne parametry wyszukiwania, w tym możliwość określenia punktu początkowego wyszukiwania oraz liczby znaków do sprawdzenia.

Najprostszą formą jest public int IndexOf(char value), która wyszukuje pojedynczy znak. Dostępna jest również publiczna metoda int IndexOf(string value) służąca do wyszukiwania podciągu. Wersje zaawansowane pozwalają na określenie indeksu początkowego lub zarówno indeksu początkowego, jak i liczby, zwiększając wszechstronność metody w operacjach wyszukiwania.

Korzystanie z IndexOf

Aby zilustrować użycie funkcji IndexOf, rozważmy scenariusz, w którym trzeba znaleźć pozycję znaku lub podciągu w większym ciągu znaków. Oto prosty przykład:

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);
}

Public Shared Sub Main(ByVal args() As String)
	Dim str As String = "Hello, world!"
	Dim index As Integer = str.IndexOf("o"c)
	Console.WriteLine("The index of 'o' is: " & index)
End Sub

Zgodnie z tym przykładem fragment kodu lokalizuje pierwsze wystąpienie znaku "o", wyświetlając następujący wynik wskazujący jego pozycję. Wynik będzie następujący:

Indeks litery "o" to: 4

Należy pamiętać, że indeksowanie zaczyna się od zera, co oznacza, że pierwszy znak ciągu zaczyna się od indeksu 0.

Określanie indeksu początkowego

Metoda IndexOf w języku C# jest podstawowym narzędziem do manipulacji ciągami znaków, służącym do lokalizowania określonego znaku lub podciągu w innym ciągu znaków. Jest to szczególnie przydatne, gdy chcesz znaleźć kolejne wystąpienia znaku lub podciągu. Na przykład:

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);

Dim value As String = "Brown fox jumps over"
Dim startIndex As Integer = value.IndexOf("o"c) + 1
Dim index As Integer = value.IndexOf("o"c, startIndex)
Console.WriteLine("The index of the second 'o' is: " & index)

Najpierw kod wyszukuje pierwsze wystąpienie litery "o", a następnie szuka kolejnej litery "o", zaczynając od miejsca tuż za pierwszym znalezionym indeksem.

Po uruchomieniu kodu konsola wyświetla następujący wynik:

Indeks drugiej litery "o" to 7

Wyszukiwanie za pomocą Start Index i Count

Bardziej szczegółowe zapytanie wymaga określenia zarówno indeksu początkowego, jak i liczby, jak pokazano w poniższym przykładzie, w celu usprawnienia wyszukiwania. Ogranicza to wyszukiwanie do określonego zakresu w ciągu znaków, optymalizując wydajność i precyzję. Oto jak to zrobić:

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);

Dim sample As String = "Sample text for testing"
Dim startindex As Integer = 7
Dim count As Integer = 10
Dim result As Integer = sample.IndexOf("text", startindex, count)
Console.WriteLine("Index of 'text': " & result)

Ten fragment kodu wyszukuje słowo "text" w określonym zakresie, demonstrując elastyczność metody w zawężaniu obszaru wyszukiwania w dużych ciągach znaków.

Po uruchomieniu tego kodu konsola wyświetla:

Indeks "tekstu": 7

Wyszukiwanie nieistniejących elementów

Częstym scenariuszem jest próba znalezienia znaku lub podciągu, który nie występuje w ciągu znaków. W takich przypadkach metoda zwraca wartość wyniku -1, wskazującą wynik wyszukiwania. Jest to ważny warunek, który należy sprawdzić, aby uniknąć błędów w kodzie. Oto jak to zrobić:

string phrase = "Searching for a missing character";
int index = phrase.IndexOf('x'); // 'x' does not exist in the string
if (index == -1)
{
    Console.WriteLine("Nie znaleziono znaku.");
}
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("Nie znaleziono znaku.");
}
else
{
    Console.WriteLine("Character found at index: " + index);
}

Imports System

Dim phrase As String = "Searching for a missing character"
Dim index As Integer = phrase.IndexOf("x"c) ' 'x' does not exist in the string
If index = -1 Then
    Console.WriteLine("Nie znaleziono znaku.")
Else
    Console.WriteLine("Character found at index: " & index)
End If

Po uruchomieniu tego kodu konsola wyświetla:

Nie znaleziono znaku.

Postępowanie z pustymi ciągami znaków

Innym szczególnym przypadkiem jest sytuacja, gdy ciąg wyszukiwania lub ciąg docelowy jest pusty. Metoda IndexOf traktuje początek dowolnego ciągu znaków (nawet pustego) jako prawidłową pozycję dla pustego podciągu. Dlatego wyszukiwanie pustego ciągu znaków w dowolnym ciągu znaków zwraca 0, co oznacza początek ciągu znaków. Z drugiej strony, wyszukiwanie w pustym ciągu dowolnego niepustego podciągu zwróci -1, ponieważ nie ma możliwego dopasowania. Zrozumienie tego zachowania ma kluczowe znaczenie dla uzyskania dokładnych wyników wyszukiwania.

Wrażliwość na wielkość liter i kwestie kulturowe

Domyślnie metoda IndexOf rozróżnia wielkość liter. Oznacza to, że wyszukiwanie litery "a" różni się od wyszukiwania litery "A". W zależności od wymagań aplikacji może być konieczne przeprowadzenie wyszukiwania bez uwzględniania wielkości liter. Można to osiągnąć, używając metody IndexOf, która przyjmuje wyliczenie StringComparison jako parametr. Ponadto IndexOf uwzględnia zasady kulturowe dotyczące porównywania ciągów znaków, co może wpływać na wyniki wyszukiwania znaków Unicode. W przypadku aplikacji o specyficznych wymaganiach kulturowych lub językowych zachowanie to można dostosować za pomocą przeciążenia, które akceptuje obiekt CultureInfo.

Przykład: Wyszukiwanie bez rozróżniania wielkości liter

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.");
}

Dim data As String = "Case-Insensitive Search Example"
Dim indexInsensitive As Integer = data.IndexOf("search", StringComparison.OrdinalIgnoreCase)
If indexInsensitive >= 0 Then
	Console.WriteLine("Substring found at index: " & indexInsensitive)
Else
	Console.WriteLine("Substring not found.")
End If

Ten fragment kodu pokazuje, jak przeprowadzić wyszukiwanie bez uwzględniania wielkości liter, zapewniając, że różnice w wielkości liter nie wpływają na możliwość zlokalizowania podciągów w ciągu znaków.

Przykład kodu

Aby skorzystać z tego przykładu, upewnij się, że masz zainstalowany IronPDF w swoim projekcie. Jeśli nie, można go łatwo dodać za pomocą menedżera pakietów NuGet, używając polecenia:

Install-Package IronPdf

Aby zintegrować funkcjonalność IronPDF z operacją IndexOf w języku C#, zazwyczaj rozważasz scenariusz, w którym chcesz znaleźć konkretny tekst w dokumencie PDF i być może w jakiś sposób manipulować tym tekstem lub wchodzić z nim w interakcję.

Poniższy przykład ma charakter koncepcyjny i skupia się na procesie wyodrębniania tekstu z pliku PDF, a następnie użyciu metody IndexOf do znalezienia pozycji określonego podciągu w tym tekście. Należy pamiętać, że API IronPDF może nie udostępniać bezpośrednio metody o nazwie IndexOf, ponieważ jest to metoda klasy string w języku C#.

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.");
        }
    }
}

Imports IronPdf
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create an instance of the IronPDF PDF document reader
		Dim pdfDocument = PdfDocument.FromFile("path/to/your/document.pdf")
		' Extract all text from the PDF document
		Dim allText = pdfDocument.ExtractAllText()
		' The text you want to search for in the PDF document
		Dim searchText As String = "specific text"
		' Use IndexOf to find the position of searchText in the extracted text
		Dim position As Integer = allText.IndexOf(searchText)
		If position <> -1 Then
			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.")
		End If
	End Sub
End Class

Ten fragment kodu stanowi podstawową strukturę do otwierania pliku PDF, wyodrębniania jego treści tekstowej oraz wyszukiwania określonego ciągu znaków w tej treści.

Po uruchomieniu tego kodu konsola wyświetla: Tekst znaleziony w pozycji: 1046