Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes