IndexOf C# (Geliştiriciler için Nasıl Çalışır)

IndexOf'un Sözdizimi

C#'daki IndexOf'un temel sözdizimi oldukça açıktır. Metod, esnek arama parametreleri sağlamak için birkaç aşırı yükleme ile gelir, aramanın başlangıç noktasını ve inceleyeceği karakter sayısını belirtme yeteneği dahil.

En basit form public int IndexOf(char value) olup, tek bir karakteri arar. public int IndexOf(string value) ise bir alt dize aramak için kullanılır. Gelişmiş sürümler, başlangıç indeksini veya hem bir başlangıç indeksini hem de bir sayıyı belirtmenize olanak tanıyarak yöntemin aramalarda esnekliğini artırır.

IndexOf Kullanımı

IndexOf kullanımını açıklamak için, büyük bir dize içinde bir karakterin veya alt dizenin yerini bulmanız gereken bir senaryoyu düşünün. İşte basit bir örnek:

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

Bu örneği takip ederek, snippet 'o' karakterinin ilk kez nerede bulunduğunu belirler ve yerini gösterir. Çıktı şu şekilde olacak:

'o' karakterinin indeksi: 4

Dikkat edin, indeks sıfır tabanlıdır, yani ilk dize karakteri indeks 0 ile başlar.

Başlangıç İndeksini Belirleme

C# dilinde string IndexOf metodu, başka bir dize içinde belirli bir karakteri veya alt diziyi bulma konusunda yetenekli bir dize işleme aracıdır. Özellikle bir karakterin veya alt dizenin sonraki vakalarını bulmayı istediğinizde kullanışlıdır. Örneğin:

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)

Önce kod 'o' karakterinin ilk vakasını bulur ve sonra ilk bulduğu indeksin hemen ardından bir sonraki 'o' için arama yapar.

Kod çalıştırıldığında, konsol çıkışı şöyledir:

İkinci 'o' karakterinin indeksi 7

Başlangıç İndeksi ve Sayı ile Arama

Daha ayrıntılı bir araştırma, başlangıç indeksini ve sayıyı belirtmeyi içerir; bu, aşağıdaki örnekte gösterildiği gibi aramaları geliştirmek için kullanılır. Bu, aramayı dizenin belirli bir aralığıyla sınırlandırır, performans ve doğruluğu optimize eder. İşte bunun nasıl yapıldığı:

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)

Bu snippet, dizenin belirlenen bir aralığı içinde 'metin' kelimesini arar ve yöntemin büyük dizeler içinde arama alanını daraltma esnekliğini gösterir.

Bu kod çalıştırıldığında, konsol çıktısı:

'text' indeks: 7

Mevcut Olmayan Öğeleri Arama

Yaygın bir senaryo, dizede bulunmayan bir karakter veya alt dizeyi aramaya çalışmaktır. Bu durumlarda, yöntem aramanın sonucunu belirten -1 değerini döndürür. Bu, kodunuzda hataları önlemek için kontrol etmeniz gereken önemli bir durumdur. Bunu ele almak için işte yapmanız gerekenler:

string phrase = "Searching for a missing character";
int index = phrase.IndexOf('x'); // 'x' does not exist in the string
if (index == -1)
{
    Console.WriteLine("Karakter bulunamadı.");
}
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("Karakter bulunamadı.");
}
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("Karakter bulunamadı.")
Else
    Console.WriteLine("Character found at index: " & index)
End If

Bu kod çalıştırıldığında, konsol çıktısı:

Karakter bulunamadı.

Boş Dizelerle Uğraşma

Diğer özel durum, arama dizgesi veya hedef dizgenin boş olması durumudur. IndexOf, herhangi bir dizenin başlangıcını (boş bir dize dahil) boş bir alt dize için geçerli bir konum olarak kabul eder. Bu nedenle, herhangi bir dizede boş bir dize aramak, dizenin başlangıcını gösteren 0 değerini döndürür. Aksine, boş bir dizede herhangi bir dolu alt dize aramak -1 döndürecektir, çünkü uygun bir eşleşme yoktur. Bu davranışı anlamak, doğru arama sonuçları için çok önemlidir.

Büyük/Küçük Harf Duyarlılığı ve Kültürel Dikkatler

Varsayılan olarak, IndexOf yöntemi büyük/küçük harf duyarlıdır. Bu, 'a' aramanın 'A' aramaktan farklı olduğu anlamına gelir. Uygulamanızın gereksinimlerine bağlı olarak, büyük/küçük harf duyarsız aramalar yapmanız gerekebilir. Bu, bir parametre olarak StringComparison numaralandırmasını kabul eden IndexOf yöntemi kullanılarak yapılabilir. Ek olarak, IndexOf, Unicode karakterleri için arama sonuçlarını etkileyebilecek kültürel kuralları dikkate alır. Belirli kültürel veya dilsel gereksinimleri olan uygulamalar için, bu davranış CultureInfo nesnesi kabul eden aşırı yüklerle ayarlanabilir.

Örnek: Büyük/Küçük Harf Duyarsız Arama

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

Bu kod parçası, bir alt dizenin konumunu belirlemede büyük harf kullanımlarının etkisini olmayacak şekilde büyük/küçük harf duyarsız bir arama nasıl yapılacağını gösterir.

Kod Örneği

Lütfen bu örneği kullanmak için projenizde IronPDF'nin yüklü olduğundan emin olun. Değilse, NuGet Paket Yöneticisi aracılığıyla kolayca ekleyebilirsiniz:

Install-Package IronPdf

IronPDF'nin işlevselliğini C#'ta bir IndexOf işlemi ile entegre etmek için genellikle bir PDF belgesi içinde belirli bir metni bulmayı ve belki de o metinle bir şekilde etkileşime geçmeyi düşüneceksiniz.

Aşağıdaki örnek soyut bir örnektir ve bir PDF'den metin çıkarma ve ardından metin içinde belirli bir alt dize konumunu bulma sürecine odaklanmaktadır. IronPDF API'sinin IndexOf adlı bir yöntemi doğrudan kullanıma sunmayabileceğini unutmayın, çünkü bu, C# dilinde string sınıfının bir yöntemidir.

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

Bu kod snippet'i, bir PDF'yi açmak, metin içeriğini çıkarmak ve o içerikte belirli bir dize aramak için temel bir çerçeve sunar.

Bu kod çalıştırıldığında, konsol çıktısı: Text found at position: 1046