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

CKTIS / C#

Array.IndexOf: procurar um estado permitido

Utiliza o método estático `Array.IndexOf` para encontrar a primeira ocorrência de um estado num array e verificar se esse estado é permitido.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

public static int IndexOf<T>(T[] array, T value);

// With string[] AllowedStatuses and string s2:
int index = Array.IndexOf(AllowedStatuses,s2);
bool isAllowed = index >= 0;

Em C# 12 com .NET 8, Array.IndexOf(AllowedStatuses,s2) procura o valor s2 do tipo string em todo o array unidimensional AllowedStatuses do tipo string[]. É um método estático do tipo System.Array. O compilador escolhe a sobrecarga genérica de dois argumentos IndexOf<T>(T[], T) e infere que T é string. Não escolhe a sobrecarga não genérica IndexOf(Array, object).

O método devolve um int: o índice da primeira correspondência, contando a partir de zero, ou -1 se não houver correspondência. Usa index >= 0 para verificar se o estado é permitido, mesmo quando está na primeira posição. Não uses -1 como índice do array. Se o próprio array for null, o método lança ArgumentNullException em vez de devolver -1.

O método usa a comparação de igualdade predefinida para o tipo dos elementos. Para string, a comparação é ordinal, independente da cultura e distingue maiúsculas de minúsculas. Esta sobrecarga não aceita um comparador personalizado.

Não confundas este método com uma função tua chamada IndexOf, nem com System.Collections.Generic.List<T>.IndexOf, que é chamado numa instância de uma lista, por exemplo list.IndexOf(s2).

Exemplos

using System;

string[] AllowedStatuses = { "open", "closed", "open" };
string s2 = "open";

int index = Array.IndexOf(AllowedStatuses,s2);
Console.WriteLine(index);
Console.WriteLine(index >= 0);

s2 = "Open";
index = Array.IndexOf(AllowedStatuses,s2);
Console.WriteLine(index);
Console.WriteLine(index >= 0);

Resultado

0
True
-1
False

A primeira correspondência para `"open"` está no índice `0`, por isso a condição dá `True`. Não há correspondência para `"Open"`: o resultado é `-1` e a condição dá `False`.

Lições relacionadas

  • C# · Lição 32 · Básico · Versão: 3

Fontes