Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Array.IndexOf — indeks pierwszego wystąpienia

System.Array.IndexOf wyszukuje pierwsze wystąpienie wartości w tablicy lub jej zakresie i zwraca indeks.

Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Składnia

Array.IndexOf<T>(T[] array, T value)
Array.IndexOf<T>(T[] array, T value, int startIndex)
Array.IndexOf<T>(T[] array, T value, int startIndex, int count)

System.Array.IndexOf przeszukuje tablicę jednowymiarową. Przeciążenia generyczne zwracają indeks liczony od zera albo -1, gdy brak dopasowania.

startIndex rozpoczyna zakres; count określa liczbę elementów. Wynik odnosi się do całej tablicy. Porównanie wykorzystuje EqualityComparer<T>.Default; wyszukiwanie ma złożoność O(n) dla przeszukiwanego zakresu.

Tablica null powoduje ArgumentNullException; niepoprawny zakres — ArgumentOutOfRangeException. Przeciążenia niegeneryczne przyjmują Array i object?; dla tablic wielowymiarowych zgłaszają RankException. Ich wynik przy braku dopasowania to dolna granica indeksów minus jeden, zwykle -1.

Przykłady

using System;

int[] values = { 7, 4, 7, 9 };
Console.WriteLine(Array.IndexOf(values, 7));
Console.WriteLine(Array.IndexOf(values, 7, 1));
Console.WriteLine(Array.IndexOf(values, 7, 1, 1));

Wynik

0
2
-1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła