CKTIS / C#
Array.IndexOf — índice da primeira ocorrência
System.Array.IndexOf procura a primeira ocorrência de um valor num array ou num intervalo e devolve o respetivo índice.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
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 pesquisa um array unidimensional. As sobrecargas genéricas devolvem um índice baseado em zero ou -1 quando não existe correspondência.
startIndex indica o início do intervalo; count especifica o seu comprimento. O resultado é um índice no array original. A igualdade utiliza EqualityComparer<T>.Default; a pesquisa tem complexidade O(n) no intervalo pesquisado.
Um array null provoca ArgumentNullException; um intervalo inválido provoca ArgumentOutOfRangeException. As sobrecargas não genéricas aceitam Array e object?; arrays multidimensionais provocam RankException. Quando não existe correspondência, o resultado é o limite inferior do array menos um, normalmente -1.
Exemplos
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));Resultado
0 2 -1
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.