Array.FindIndex 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

在 Array 或其某个部分中搜索与指定谓词所定义的条件相匹配的元素，并返回第一个匹配项的从零开始的索引。

重载

FindIndex<T>(T[], Predicate<T>)	搜索与指定谓词所定义的条件相匹配的元素，并返回整个 Array 中第一个匹配元素的从零开始的索引。
FindIndex<T>(T[], Int32, Predicate<T>)	搜索与指定谓词所定义的条件相匹配的元素，并返回 Array 中从指定索引到最后一个元素的元素范围内第一个匹配项的从零开始的索引。
FindIndex<T>(T[], Int32, Int32, Predicate<T>)	搜索与指定谓词所定义的条件相匹配的一个元素，并返回 Array 中从指定的索引开始、包含指定元素个数的元素范围内第一个匹配项的从零开始的索引。

示例

下面的代码示例演示泛型方法的所有三个 FindIndex 重载。创建一个字符串数组，其中包含 8 个恐龙名称，其中两个 (位置 1 和 5) 以“saurus”结尾。该代码示例还定义了一个名为 EndsWithSaurus的搜索谓词方法，该方法接受字符串参数并返回一个布尔值，该值指示输入字符串是否以“saurus”结尾。

方法 FindIndex<T>(T[], Predicate<T>) 重载从头开始遍历数组，将每个元素依次 EndsWithSaurus 传递给方法。当方法返回true位置 1 处的元素时EndsWithSaurus，搜索将停止。

注意

在 C#、F# 和 Visual Basic 中，无需在 Visual Basic) Predicate(Of String)中显式创建Predicate<string>委托 (。这些语言从上下文中推断出正确的委托，并自动创建它。

方法 FindIndex<T>(T[], Int32, Predicate<T>) 重载用于搜索从位置 2 开始并持续到数组末尾的数组。它查找位置 5 处的元素。最后， FindIndex<T>(T[], Int32, Int32, Predicate<T>) 方法重载用于从位置 2 开始搜索三个元素的范围。它返回 -1，因为该范围内没有以“saurus”结尾的恐龙名称。

using namespace System;

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

void main()
{
    array<String^>^ dinosaurs = { "Compsognathus", 
        "Amargasaurus",   "Oviraptor",      "Velociraptor", 
        "Deinonychus",    "Dilophosaurus",  "Gallimimus", 
        "Triceratops" };

    Console::WriteLine();
    for each(String^ dinosaur in dinosaurs )
    {
        Console::WriteLine(dinosaur);
    }

    Console::WriteLine("\nArray::FindIndex(dinosaurs, EndsWithSaurus): {0}", 
        Array::FindIndex(dinosaurs, gcnew Predicate<String^>(EndsWithSaurus)));

    Console::WriteLine("\nArray::FindIndex(dinosaurs, 2, EndsWithSaurus): {0}",
        Array::FindIndex(dinosaurs, 2, gcnew Predicate<String^>(EndsWithSaurus)));

    Console::WriteLine("\nArray::FindIndex(dinosaurs, 2, 3, EndsWithSaurus): {0}",
        Array::FindIndex(dinosaurs, 2, 3, gcnew Predicate<String^>(EndsWithSaurus)));
}

/* 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
 */

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>)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

搜索与指定谓词所定义的条件相匹配的元素，并返回整个 Array 中第一个匹配元素的从零开始的索引。

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

类型参数

T

数组元素的类型。

参数

array: T[]

要搜索的从零开始的一维 Array。

match: Predicate<T>

Predicate<T>，定义要搜索元素的条件。

Int32

如果找到与 match 定义的条件相匹配的第一个元素，则为该元素的从零开始的索引；否则为 -1。

例外

ArgumentNullException

array 为 null。

- 或 -

match 为 null。

注解

从 Array 第一个元素开始，在最后一个元素处结束，向前搜索。

Predicate<T>是方法的委托，如果传递给该方法的对象与委托中定义的条件匹配，则返回true该方法。的 array 元素单独传递给 Predicate<T>。

此方法是 O (n) 操作，其中 n 是 Length 的 array。

另请参阅

适用于

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

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

搜索与指定谓词所定义的条件相匹配的元素，并返回 Array 中从指定索引到最后一个元素的元素范围内第一个匹配项的从零开始的索引。

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

类型参数

T

数组元素的类型。

参数

array: T[]

要搜索的从零开始的一维 Array。

startIndex: Int32

从零开始的搜索的起始索引。

match: Predicate<T>

Predicate<T>，定义要搜索元素的条件。

Int32

如果找到与 match 定义的条件相匹配的第一个元素，则为该元素的从零开始的索引；否则为 -1。

例外

ArgumentNullException

array 为 null。

- 或 -

match 为 null。

ArgumentOutOfRangeException

startIndex 超出了 array 的有效索引范围。

注解

Array从开始startIndex，在最后一个元素处结束，向前搜索。

Predicate<T>是方法的委托，如果传递给该方法的对象与委托中定义的条件匹配，则返回true该方法。的 array 元素单独传递给 Predicate<T>。

此方法是 O (n) 操作，其中 n 是从 startIndex 到末尾的 array元素数。

另请参阅

适用于

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

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

搜索与指定谓词所定义的条件相匹配的一个元素，并返回 Array 中从指定的索引开始、包含指定元素个数的元素范围内第一个匹配项的从零开始的索引。

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

类型参数

T

数组元素的类型。

参数

array: T[]

要搜索的从零开始的一维 Array。

startIndex: Int32

从零开始的搜索的起始索引。

count: Int32

要搜索的部分中的元素数。

match: Predicate<T>

Predicate<T>，定义要搜索元素的条件。

Int32

如果找到与 match 定义的条件相匹配的第一个元素，则为该元素的从零开始的索引；否则为 -1。

例外

ArgumentNullException

array 为 null。

- 或 -

match 为 null。

ArgumentOutOfRangeException

startIndex 超出了 array 的有效索引范围。

- 或 -

count 小于零。

- 或 -

startIndex 和 count 未在 array 中指定有效部分。

注解

Array如果 count 大于 0，则从startIndex正向搜索，并在startIndex加count减 1 处结束。

Predicate<T>是方法的委托，如果传递给该方法的对象与委托中定义的条件匹配，则返回true该方法。的 array 元素单独传递给 Predicate<T>。

此方法是 O (n) 操作，其中 n 为 count。

另请参阅

适用于

Array.FindIndex 方法

定义

重载

示例

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

类型参数

参数

返回

例外

注解

另请参阅

适用于

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

类型参数

参数

返回

例外

注解

另请参阅

适用于

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

类型参数

参数

返回

例外

注解

另请参阅

适用于

反馈

其他资源