Array.FindIndex Método

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Procura um elemento que corresponda às condições definidas por um predicado especificado e devolve o índice baseado em zero da primeira ocorrência dentro de uma Array ou parte dele.

Sobrecargas

Name	Description
FindIndex<T>(T[], Predicate<T>)	Procura um elemento que corresponda às condições definidas pelo predicado especificado e devolve o índice base zero da primeira ocorrência dentro de todo Arrayo .
FindIndex<T>(T[], Int32, Predicate<T>)	Procura um elemento que corresponda às condições definidas pelo predicado especificado, e devolve o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos em que Array se estende do índice especificado até ao último elemento.
FindIndex<T>(T[], Int32, Int32, Predicate<T>)	Procura um elemento que corresponda às condições definidas pelo predicado especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos em que Array começa no índice especificado e contém o número especificado de elementos.

Exemplos

O exemplo de código seguinte demonstra as três sobrecargas do FindIndex método genérico. É criado um conjunto de cordas, contendo 8 nomes de dinossauros, dois dos quais (nas posições 1 e 5) terminam com "saurus". O exemplo de código também define um método de predicado de pesquisa chamado EndsWithSaurus, que aceita um parâmetro de cadeia e devolve um valor booleano indicando se a cadeia de entrada termina em "saurus".

A FindIndex<T>(T[], Predicate<T>) sobrecarga do método percorre o array desde o início, passando cada elemento por sua vez para o EndsWithSaurus método. A pesquisa termina quando o EndsWithSaurus método retorna true para o elemento na posição 1.

Note

Em C#, F# e Visual Basic, não é necessário criar explicitamente o delegado Predicate<string> (Predicate(Of String) em Visual Basic). Estas linguagens inferem o delegado correto a partir do contexto e criam-no automaticamente.

A FindIndex<T>(T[], Int32, Predicate<T>) sobrecarga do método é usada para pesquisar o array começando na posição 2 e continuando até ao fim do array. Encontra o elemento na posição 5. Finalmente, a FindIndex<T>(T[], Int32, Int32, Predicate<T>) sobrecarga do método é usada para procurar o intervalo de três elementos a partir da posição 2. Volta -1 porque não existem nomes de dinossauros nessa gama que terminem por "saurus".

using System;

public class Example
{
    public static void Main()
    {
        string[] dinosaurs = { "Compsognathus",
            "Amargasaurus",   "Oviraptor",      "Velociraptor",
            "Deinonychus",    "Dilophosaurus",  "Gallimimus",
            "Triceratops" };

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine(
            "\nArray.FindIndex(dinosaurs, EndsWithSaurus): {0}",
            Array.FindIndex(dinosaurs, EndsWithSaurus));

        Console.WriteLine(
            "\nArray.FindIndex(dinosaurs, 2, EndsWithSaurus): {0}",
            Array.FindIndex(dinosaurs, 2, EndsWithSaurus));

        Console.WriteLine(
            "\nArray.FindIndex(dinosaurs, 2, 3, EndsWithSaurus): {0}",
            Array.FindIndex(dinosaurs, 2, 3, EndsWithSaurus));
    }

    // Search predicate returns true if a string ends in "saurus".
    private static bool EndsWithSaurus(String s)
    {
        if ((s.Length > 5) &&
            (s.Substring(s.Length - 6).ToLower() == "saurus"))
        {
            return true;
        }
        else
        {
            return false;
        }
    }
}

/* This code example produces the following output:

Compsognathus
Amargasaurus
Oviraptor
Velociraptor
Deinonychus
Dilophosaurus
Gallimimus
Triceratops

Array.FindIndex(dinosaurs, EndsWithSaurus): 1

Array.FindIndex(dinosaurs, 2, EndsWithSaurus): 5

Array.FindIndex(dinosaurs, 2, 3, EndsWithSaurus): -1
 */

open System

// Search predicate returns true if a string ends in "saurus".
let endsWithSaurus (s: string) =
    s.Length > 5 && s.Substring(s.Length - 6).ToLower() = "saurus"

let dinosaurs =
    [| "Compsognathus"; "Amargasaurus"
       "Oviraptor"; "Velociraptor"
       "Deinonychus"; "Dilophosaurus"
       "Gallimimus"; "Triceratops" |]

printfn ""
for dino in dinosaurs do
    printfn $"{dino}"

Array.FindIndex(dinosaurs, endsWithSaurus)
|> printfn "\nArray.FindIndex(dinosaurs, EndsWithSaurus): %i"

Array.FindIndex(dinosaurs, 2, endsWithSaurus)
|> printfn "\nArray.FindIndex(dinosaurs, 2, EndsWithSaurus): %i"

Array.FindIndex(dinosaurs, 2, 3, endsWithSaurus)
|> printfn "\nArray.FindIndex(dinosaurs, 2, 3, EndsWithSaurus): %i"


// This code example produces the following output:
//
//     Compsognathus
//     Amargasaurus
//     Oviraptor
//     Velociraptor
//     Deinonychus
//     Dilophosaurus
//     Gallimimus
//     Triceratops
//
//     Array.FindIndex(dinosaurs, EndsWithSaurus): 1
//
//     Array.FindIndex(dinosaurs, 2, EndsWithSaurus): 5
//
//     Array.FindIndex(dinosaurs, 2, 3, EndsWithSaurus): -1

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs() As String = { "Compsognathus", _
            "Amargasaurus",   "Oviraptor",      "Velociraptor", _
            "Deinonychus",    "Dilophosaurus",  "Gallimimus", _
            "Triceratops" }

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & _
            "Array.FindIndex(dinosaurs, AddressOf EndsWithSaurus): {0}", _
            Array.FindIndex(dinosaurs, AddressOf EndsWithSaurus))

        Console.WriteLine(vbLf & _
            "Array.FindIndex(dinosaurs, 2, AddressOf EndsWithSaurus): {0}", _
            Array.FindIndex(dinosaurs, 2, AddressOf EndsWithSaurus))

        Console.WriteLine(vbLf & _
            "Array.FindIndex(dinosaurs, 2, 3, AddressOf EndsWithSaurus): {0}", _
            Array.FindIndex(dinosaurs, 2, 3, AddressOf EndsWithSaurus))

    End Sub

    ' Search predicate returns true if a string ends in "saurus".
    Private Shared Function EndsWithSaurus(ByVal s As String) _
        As Boolean

        ' AndAlso prevents evaluation of the second Boolean
        ' expression if the string is so short that an error
        ' would occur.
        If (s.Length > 5) AndAlso _
            (s.Substring(s.Length - 6).ToLower() = "saurus") Then
            Return True
        Else
            Return False
        End If
    End Function
End Class

' This code example produces the following output:
'
'Compsognathus
'Amargasaurus
'Oviraptor
'Velociraptor
'Deinonychus
'Dilophosaurus
'Gallimimus
'Triceratops
'
'Array.FindIndex(dinosaurs, AddressOf EndsWithSaurus): 1
'
'Array.FindIndex(dinosaurs, 2, AddressOf EndsWithSaurus): 5
'
'Array.FindIndex(dinosaurs, 2, 3, AddressOf EndsWithSaurus): -1

FindIndex<T>(T[], Predicate<T>)

Procura um elemento que corresponda às condições definidas pelo predicado especificado e devolve o índice base zero da primeira ocorrência dentro de todo Arrayo .

public:
generic <typename T>
 static int FindIndex(cli::array <T> ^ array, Predicate<T> ^ match);

public static int FindIndex<T>(T[] array, Predicate<T> match);

static member FindIndex : 'T[] * Predicate<'T> -> int

Public Shared Function FindIndex(Of T) (array As T(), match As Predicate(Of T)) As Integer

Parâmetros de Tipo Genérico

T

O tipo dos elementos da matriz.

Parâmetros

array: T[]

A pesquisa unidimensional, baseada Array em zero.

match: Predicate<T>

O Predicate<T> que define as condições do elemento a procurar.

Devoluções

Int32

O índice baseado em zero da primeira ocorrência de um elemento que corresponde às condições definidas por match, se encontrado; caso contrário, -1.

Exceções

ArgumentNullException

array é null.

-ou-

match é null.

Observações

É Array procurado para a frente começando pelo primeiro elemento e terminando no último elemento.

O Predicate<T> é um delegado a um método que retorna true se o objeto passado corresponder às condições definidas no delegado. Os elementos de array são passados individualmente para o Predicate<T>.

Este método é uma operação O(n), onde n é o Length de array.

Ver também

Aplica-se a

FindIndex<T>(T[], Int32, Predicate<T>)

Procura um elemento que corresponda às condições definidas pelo predicado especificado, e devolve o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos em que Array se estende do índice especificado até ao último elemento.

public:
generic <typename T>
 static int FindIndex(cli::array <T> ^ array, int startIndex, Predicate<T> ^ match);

public static int FindIndex<T>(T[] array, int startIndex, Predicate<T> match);

static member FindIndex : 'T[] * int * Predicate<'T> -> int

Public Shared Function FindIndex(Of T) (array As T(), startIndex As Integer, match As Predicate(Of T)) As Integer

Parâmetros de Tipo Genérico

T

O tipo dos elementos da matriz.

Parâmetros

array: T[]

A pesquisa unidimensional, baseada Array em zero.

startIndex: Int32

O índice inicial baseado em zero da pesquisa.

match: Predicate<T>

O Predicate<T> que define as condições do elemento a procurar.

Devoluções

Int32

O índice baseado em zero da primeira ocorrência de um elemento que corresponde às condições definidas por match, se encontrado; caso contrário, -1.

Exceções

ArgumentNullException

array é null.

-ou-

match é null.

ArgumentOutOfRangeException

startIndex é menor que zero ou maior que o comprimento do array.

Observações

A Array procura para a frente começando e startIndex terminando no último elemento.

Este método é uma operação O(n), onde n é o número de elementos de startIndex até ao fim de array.

Ver também

Aplica-se a

FindIndex<T>(T[], Int32, Int32, Predicate<T>)

Procura um elemento que corresponda às condições definidas pelo predicado especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos em que Array começa no índice especificado e contém o número especificado de elementos.

public:
generic <typename T>
 static int FindIndex(cli::array <T> ^ array, int startIndex, int count, Predicate<T> ^ match);

public static int FindIndex<T>(T[] array, int startIndex, int count, Predicate<T> match);

static member FindIndex : 'T[] * int * int * Predicate<'T> -> int

Public Shared Function FindIndex(Of T) (array As T(), startIndex As Integer, count As Integer, match As Predicate(Of T)) As Integer

Parâmetros de Tipo Genérico

T

O tipo dos elementos da matriz.

Parâmetros

array: T[]

A pesquisa unidimensional, baseada Array em zero.

startIndex: Int32

O índice inicial baseado em zero da pesquisa.

count: Int32

O número de elementos na secção a pesquisar.

match: Predicate<T>

O Predicate<T> que define as condições do elemento a procurar.

Devoluções

Int32

O índice baseado em zero da primeira ocorrência de um elemento que corresponde às condições definidas por match, se encontrado; caso contrário, -1.

Exceções

ArgumentNullException

array é null.

-ou-

match é null.

ArgumentOutOfRangeException

startIndex é menor que zero ou maior que o comprimento do array.

-ou-

count é inferior a zero.

-ou-

startIndex e count não especificam uma secção válida em array.

Observações

O Array é procurado para a frente começando em startIndex e terminando em startIndex mais count menos 1, se count for maior que 0.

Este método é uma operação O(n), onde n é count.

Ver também

Aplica-se a

Comentários

Esta página foi útil?