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

IndexOf'un Sözdizimi

C# dilinde IndexOf temel söz dizimi oldukça basittir. Yöntem, arama işlemi için başlangıç noktasını ve incelenecek karakter sayısını belirtme yeteneği dahil olmak üzere esnek arama parametrelerine izin veren birkaç fazla yüklemeye sahiptir.

En basit hali public int IndexOf(char value) şeklindedir ve tek bir karakteri arar. Alt dizi araması için public int IndexOf(string value) versiyonu da vardır. Gelişmiş sürümler, başlangıç indeksini veya hem başlangıç indeksini hem de sayıyı belirleyerek yöntemin arama işlemlerindeki esnekliğini artırır.

IndexOf Kullanma

IndexOf kullanımını göstermek için, daha büyük bir dize içinde bir karakterin veya alt dizenin konumunu bulmanız gerektiği bir senaryo 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 takiben, bu kod parçası, 'o' karakterinin ilk geçiş yerini bulur ve konumunu belirten şu çıktıyı görüntüler. Cikti su sekilde olacak:

'o' karakterinin indeks numarası: 4

Not: İndeks sıfır tabanlıdır, yani ilk dize karakteri indeks 0'dan başlar.

Başlangıç İndeksi Belirleme

C# dilinde string IndexOf yöntemi, belirtilen karakteri veya alt diziyi başka bir dize içinde bulma konusunda yetenekli, temel bir dize manipülasyon aracıdır. Bu, bir karakterin veya alt dizenin ardışık geçişlerini bulmak istediğinizde özellikle yararlı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, 'o' karakterinin ilk geçiş yeri bulunur ve ardından bu karakterin sonraki geçişi, bulunmuş olan ilk indeksin hemen ardından aranır.

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

İkinci 'o' karakterinin indeks numarası 7

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

Daha ayrıntılı bir inceleme, aşağıdaki örnekte gösterildiği gibi, başlangıç indeksini ve sayıyı belirterek aramaları kolaylaştırmayı içerir. Bu, performansı ve hassasiyeti optimize ederek aramayı dize içinde belirli bir alanla sınırlar. İşte bu şekilde yapılır:

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 kod parçası, büyük dizelerde arama alanını daraltmada yöntemin esnekliğini göstererek belirli bir aralık içinde 'metin' kelimesini arar.

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

'metin' kelimesinin indeksi: 7

Mevcut Olmayan Öğeler İçin Arama

Yaygın bir senaryo, dizede bulunmayan bir karakteri veya alt diziyi bulmaya çalışmaktır. Bu durumlarda, yöntem aramanın sonucunu belirten -1 sonucunu döndürür. Bu, kodunuzda hatalardan kaçınmak için kontrol edilmesi gereken önemli bir durumdur. Bunu idare etmenin yolu şu şekildedir:

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 Baş Etme

Bir diğer özel durum, arama dizesinin veya hedef dize boş olduğunda meydana gelir. IndexOf, herhangi bir dizeyi (hatta boş olanı bile) boş bir alt dize için geçerli bir konum olarak kabul eder. Bu nedenle, herhangi bir dizede boş bir dizeyi aramak, dizenin başlangıcı olduğunu belirtmek için 0 döner. Tersine, boş bir dizede herhangi bir boş olmayan alt diziyi aramak, -1 döndürecektir, çünkü eşleşme mümkün değildir. Bu davranışı anlamak, doğru arama sonuçları için çok önemlidir.

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

Varsayılan olarak, IndexOf yöntemi büyük/küçük harf duyarlıdır. Bu, 'a' aramanın 'A' aramadan farklı olduğu anlamına gelir. Uygulamanızın gereksinimlerine bağlı olarak, büyük/küçük harf duyarlılığı olmayan aramalar gerçekleştirmeniz gerekebilir. Bu, bir parametre olarak StringComparison seçimini kabul eden IndexOf yöntemi kullanılarak gerçekleştirilebilir. Ayrıca, IndexOf Unicode karakterlerin arama sonuçlarını etkileyebilecek kültürel kurallara saygı duyar. Özel kültürel veya dilbilimsel gereksinimlere sahip uygulamalar için, bu davranış, bir CultureInfo nesnesini kabul eden fazla yüklemeler kullanılarak ayarlanabilir.

Örnek: Büyük/Küçük Harf Duyarlılığı Olmayan 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çacığı, baş harf değişkenliklerinin dizenin içindeki alt dizeleri bulma yeteneğini etkilememesini sağlamak için büyük/küçük harf duyarlılığı olmayan bir arama nasıl gerçekleştirilir gösterir.

Kod Örneği

Bu örneği kullanabilmek için projenize IronPDF'nin kurulu olduğundan emin olun. Değilse, NuGet Paket Yöneticisi aracılığıyla şu komutla kolayca ekleyebilirsiniz:

Install-Package IronPdf

IronPDF'nin işlevselliğini C# dilindeki bir IndexOf işlemi ile entegre etmek için tipik olarak, bir PDF belgesinde belirli bir metni bulmak ve belki o metinle bir şekilde etkileşimde bulunmak veya onu manipüle etmekle ilgilendiğiniz bir senaryoya bakıyor olacaksınız.

Alttaki örnek kavramsaldır ve bir PDF'den metin çıkarmanın sürecine, ardından bu metin içinde belirli bir alt dizenin konumunu bulmak için IndexOf yöntemini kullanmaya odaklanır. IronPDF'nin API'sinin doğrudan IndexOf adlı bir yöntemi göstermeyebileceğini unutmayın, çünkü bu C# dilindeki string sınıfına ait bir yöntemdir.

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 parçacığı, bir PDF'yi açmanın, metin içeriğini çıkarmanın ve ardından bu içerikte belirli bir dizeyi aramanın temel çerçevesini sunar.

Bu kod çalıştırıldığında konsol çıktısı: Metin şu konumda bulundu: 1046