Array.FindIndex Array.FindIndex Array.FindIndex Array.FindIndex Method

Definicja

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w Array lub jego części.Searches for an element that matches the conditions defined by a specified predicate, and returns the zero-based index of the first occurrence within an Array or a portion of it.

Przeciążenia

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

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w całości Array.Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire Array.

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

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w zakresie elementów w programie Array , który rozciąga się od określonego indeksu do ostatniego elementu.Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the Array that extends from the specified index to the last element.

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

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w zakresie elementów Array , który zaczyna się od określonego indeksu i zawiera określoną liczbę elementów.Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the Array that starts at the specified index and contains the specified number of elements.

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

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w całości Array.Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire 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

Parametry typu

T

Typ elementów tablicy.The type of the elements of the array.

Parametry

array
T[]

Jednowymiarowa, zerowa na podstawie Array wyszukiwania.The one-dimensional, zero-based Array to search.

match
Predicate<T> Predicate<T> Predicate<T> Predicate<T>

Definiuje warunki elementu, którymazostaćwyszukany.Predicate<T>The Predicate<T> that defines the conditions of the element to search for.

Zwraca

Indeks (liczony od zera) pierwszego wystąpienia elementu, który jest zgodny z warunkami zdefiniowanymi przez match, jeśli został znaleziony; w przeciwnym razie-1.The zero-based index of the first occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.

Wyjątki

arrayjest null.array is null.

—lub—-or- matchjest null.match is null.

Przykłady

Poniższy przykład kodu demonstruje wszystkie trzy przeciążenia FindIndex metody ogólnej.The following code example demonstrates all three overloads of the FindIndex generic method. Tworzona jest tablica ciągów zawierająca 8 nazw dinozaurów, przy czym dwie z nich (w pozycjach 1 i 5) kończą się na „saurus”.An array of strings is created, containing 8 dinosaur names, two of which (at positions 1 and 5) end with "saurus". W przykładzie kodu jest również definiowana Metoda wyszukiwania EndsWithSauruspredykatu o nazwie, która akceptuje parametr String i zwraca wartość logiczną wskazującą, czy ciąg wejściowy jest kończący się na "saurus".The code example also defines a search predicate method named EndsWithSaurus, which accepts a string parameter and returns a Boolean value indicating whether the input string ends in "saurus".

Przeciążenie metody przechodzi tablicę od początku, przekazując każdy element z kolei EndsWithSaurus do metody. FindIndex<T>(T[], Predicate<T>)The FindIndex<T>(T[], Predicate<T>) method overload traverses the array from the beginning, passing each element in turn to the EndsWithSaurus method. Wyszukiwanie jest zatrzymywane, EndsWithSaurus gdy metoda true zwraca dla elementu na pozycji 1.The search stops when the EndsWithSaurus method returns true for the element at position 1.

Uwaga

W C# i Visual Basic nie jest konieczne jawne utworzenie Predicate<string> delegata (Predicate(Of String) w Visual Basic).In C# and Visual Basic, it is not necessary to create the Predicate<string> delegate (Predicate(Of String) in Visual Basic) explicitly. Te języki wnioskują o poprawnym delegacie z kontekstu, a następnie są tworzone automatycznie.These languages infer the correct delegate from context and create it automatically.

Przeciążenie FindIndex<T>(T[], Int32, Predicate<T>) metody służy do przeszukiwania tablicy, zaczynając od pozycji 2 i do końca tablicy.The FindIndex<T>(T[], Int32, Predicate<T>) method overload is used to search the array beginning at position 2 and continuing to the end of the array. Znajduje element na pozycji 5.It finds the element at position 5. Na koniec Przeciążenie metody służy do przeszukiwania zakresu trzech elementów, zaczynając od pozycji 2. FindIndex<T>(T[], Int32, Int32, Predicate<T>)Finally, the FindIndex<T>(T[], Int32, Int32, Predicate<T>) method overload is used to search the range of three elements beginning at position 2. Zwraca wartość-1, ponieważ w tym zakresie nie ma nazw dinozaurów kończących się na "saurus".It returns -1 because there are no dinosaur names in that range that end with "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
 */
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

Uwagi

Array Jest przeszukiwany do przodu, zaczynając od pierwszego elementu i kończąc na ostatnim elemencie.The Array is searched forward starting at the first element and ending at the last element.

Jest delegatem metody, która zwraca true , jeśli obiekt przeszedł do niego, odpowiada warunkom zdefiniowanym w obiekcie delegowanym. Predicate<T>The Predicate<T> is a delegate to a method that returns true if the object passed to it matches the conditions defined in the delegate. Elementy array są indywidualnie przenoszone Predicate<T>do.The elements of array are individually passed to the Predicate<T>.

Ta metoda jest operacją on(), gdzie n jest Length z array.This method is an O(n) operation, where n is the Length of array.

Zobacz też

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

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w zakresie elementów w programie Array , który rozciąga się od określonego indeksu do ostatniego elementu.Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the Array that extends from the specified index to the last element.

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

Parametry typu

T

Typ elementów tablicy.The type of the elements of the array.

Parametry

array
T[]

Jednowymiarowa, zerowa na podstawie Array wyszukiwania.The one-dimensional, zero-based Array to search.

startIndex
Int32 Int32 Int32 Int32

Wartość początkowa indeksu zaczynającego się od zera dla wyszukiwania.The zero-based starting index of the search.

match
Predicate<T> Predicate<T> Predicate<T> Predicate<T>

Definiuje warunki elementu, którymazostaćwyszukany.Predicate<T>The Predicate<T> that defines the conditions of the element to search for.

Zwraca

Indeks (liczony od zera) pierwszego wystąpienia elementu, który jest zgodny z warunkami zdefiniowanymi przez match, jeśli został znaleziony; w przeciwnym razie-1.The zero-based index of the first occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.

Wyjątki

arrayjest null.array is null.

—lub—-or- matchjest null.match is null.

startIndexznajduje się poza zakresem prawidłowych indeksów arraydla.startIndex is outside the range of valid indexes for array.

Przykłady

Poniższy przykład kodu demonstruje wszystkie trzy przeciążenia FindIndex metody ogólnej.The following code example demonstrates all three overloads of the FindIndex generic method. Tworzona jest tablica ciągów zawierająca 8 nazw dinozaurów, przy czym dwie z nich (w pozycjach 1 i 5) kończą się na „saurus”.An array of strings is created, containing 8 dinosaur names, two of which (at positions 1 and 5) end with "saurus". W przykładzie kodu jest również definiowana Metoda wyszukiwania EndsWithSauruspredykatu o nazwie, która akceptuje parametr String i zwraca wartość logiczną wskazującą, czy ciąg wejściowy jest kończący się na "saurus".The code example also defines a search predicate method named EndsWithSaurus, which accepts a string parameter and returns a Boolean value indicating whether the input string ends in "saurus".

Przeciążenie metody przechodzi tablicę od początku, przekazując każdy element z kolei EndsWithSaurus do metody. FindIndex<T>(T[], Predicate<T>)The FindIndex<T>(T[], Predicate<T>) method overload traverses the array from the beginning, passing each element in turn to the EndsWithSaurus method. Wyszukiwanie jest zatrzymywane, EndsWithSaurus gdy metoda true zwraca dla elementu na pozycji 1.The search stops when the EndsWithSaurus method returns true for the element at position 1.

Uwaga

W C# i Visual Basic nie jest konieczne jawne utworzenie Predicate<string> delegata (Predicate(Of String) w Visual Basic).In C# and Visual Basic, it is not necessary to create the Predicate<string> delegate (Predicate(Of String) in Visual Basic) explicitly. Te języki wnioskują o poprawnym delegacie z kontekstu, a następnie są tworzone automatycznie.These languages infer the correct delegate from context and create it automatically.

Przeciążenie FindIndex<T>(T[], Int32, Predicate<T>) metody służy do przeszukiwania tablicy, zaczynając od pozycji 2 i do końca tablicy.The FindIndex<T>(T[], Int32, Predicate<T>) method overload is used to search the array beginning at position 2 and continuing to the end of the array. Znajduje element na pozycji 5.It finds the element at position 5. Na koniec Przeciążenie metody służy do przeszukiwania zakresu trzech elementów, zaczynając od pozycji 2. FindIndex<T>(T[], Int32, Int32, Predicate<T>)Finally, the FindIndex<T>(T[], Int32, Int32, Predicate<T>) method overload is used to search the range of three elements beginning at position 2. Zwraca wartość-1, ponieważ w tym zakresie nie ma nazw dinozaurów kończących się na "saurus".It returns -1 because there are no dinosaur names in that range that end with "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
 */
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

Uwagi

Jest przeszukiwany do przodu startIndex i kończący się na ostatnim elemencie. ArrayThe Array is searched forward starting at startIndex and ending at the last element.

Jest delegatem metody, która zwraca true , jeśli obiekt przeszedł do niego, odpowiada warunkom zdefiniowanym w obiekcie delegowanym. Predicate<T>The Predicate<T> is a delegate to a method that returns true if the object passed to it matches the conditions defined in the delegate. Elementy array są indywidualnie przenoszone Predicate<T>do.The elements of array are individually passed to the Predicate<T>.

Ta metoda jest operacją on(), gdzie n jest liczbą elementów arrayod startIndex do końca.This method is an O(n) operation, where n is the number of elements from startIndex to the end of array.

Zobacz też

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

Wyszukuje element, który odpowiada warunkom zdefiniowanym przez określony predykat, i zwraca indeks (liczony od zera) pierwszego wystąpienia w zakresie elementów Array , który zaczyna się od określonego indeksu i zawiera określoną liczbę elementów.Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the Array that starts at the specified index and contains the specified number of elements.

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

Parametry typu

T

Typ elementów tablicy.The type of the elements of the array.

Parametry

array
T[]

Jednowymiarowa, zerowa na podstawie Array wyszukiwania.The one-dimensional, zero-based Array to search.

startIndex
Int32 Int32 Int32 Int32

Wartość początkowa indeksu zaczynającego się od zera dla wyszukiwania.The zero-based starting index of the search.

count
Int32 Int32 Int32 Int32

Liczba elementów w sekcji do wyszukania.The number of elements in the section to search.

match
Predicate<T> Predicate<T> Predicate<T> Predicate<T>

Definiuje warunki elementu, którymazostaćwyszukany.Predicate<T>The Predicate<T> that defines the conditions of the element to search for.

Zwraca

Indeks (liczony od zera) pierwszego wystąpienia elementu, który jest zgodny z warunkami zdefiniowanymi przez match, jeśli został znaleziony; w przeciwnym razie-1.The zero-based index of the first occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.

Wyjątki

arrayjest null.array is null.

—lub—-or- matchjest null.match is null.

startIndexznajduje się poza zakresem prawidłowych indeksów arraydla.startIndex is outside the range of valid indexes for array.

—lub—-or- countjest mniejsza od zera.count is less than zero.

—lub—-or- startIndexi count nie określaj prawidłowej sekcji w array.startIndex and count do not specify a valid section in array.

Przykłady

Poniższy przykład kodu demonstruje wszystkie trzy przeciążenia FindIndex metody ogólnej.The following code example demonstrates all three overloads of the FindIndex generic method. Tworzona jest tablica ciągów zawierająca 8 nazw dinozaurów, przy czym dwie z nich (w pozycjach 1 i 5) kończą się na „saurus”.An array of strings is created, containing 8 dinosaur names, two of which (at positions 1 and 5) end with "saurus". W przykładzie kodu jest również definiowana Metoda wyszukiwania EndsWithSauruspredykatu o nazwie, która akceptuje parametr String i zwraca wartość logiczną wskazującą, czy ciąg wejściowy jest kończący się na "saurus".The code example also defines a search predicate method named EndsWithSaurus, which accepts a string parameter and returns a Boolean value indicating whether the input string ends in "saurus".

Przeciążenie metody przechodzi tablicę od początku, przekazując każdy element z kolei EndsWithSaurus do metody. FindIndex<T>(T[], Predicate<T>)The FindIndex<T>(T[], Predicate<T>) method overload traverses the array from the beginning, passing each element in turn to the EndsWithSaurus method. Wyszukiwanie jest zatrzymywane, EndsWithSaurus gdy metoda true zwraca dla elementu na pozycji 1.The search stops when the EndsWithSaurus method returns true for the element at position 1.

Uwaga

W C# i Visual Basic nie jest konieczne jawne utworzenie Predicate<string> delegata (Predicate(Of String) w Visual Basic).In C# and Visual Basic, it is not necessary to create the Predicate<string> delegate (Predicate(Of String) in Visual Basic) explicitly. Te języki wnioskują o poprawnym delegacie z kontekstu, a następnie są tworzone automatycznie.These languages infer the correct delegate from context and create it automatically.

Przeciążenie FindIndex<T>(T[], Int32, Predicate<T>) metody służy do przeszukiwania tablicy, zaczynając od pozycji 2 i do końca tablicy.The FindIndex<T>(T[], Int32, Predicate<T>) method overload is used to search the array beginning at position 2 and continuing to the end of the array. Znajduje element na pozycji 5.It finds the element at position 5. Na koniec Przeciążenie metody służy do przeszukiwania zakresu trzech elementów, zaczynając od pozycji 2. FindIndex<T>(T[], Int32, Int32, Predicate<T>)Finally, the FindIndex<T>(T[], Int32, Int32, Predicate<T>) method overload is used to search the range of three elements beginning at position 2. Zwraca wartość-1, ponieważ w tym zakresie nie ma nazw dinozaurów kończących się na "saurus".It returns -1 because there are no dinosaur names in that range that end with "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
 */
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

Uwagi

count count startIndex startIndex Program jest przeszukiwany do przodu, rozpoczynając od i kończąc o minus 1, jeśli jest większy niż 0. ArrayThe Array is searched forward starting at startIndex and ending at startIndex plus count minus 1, if count is greater than 0.

Jest delegatem metody, która zwraca true , jeśli obiekt przeszedł do niego, odpowiada warunkom zdefiniowanym w obiekcie delegowanym. Predicate<T>The Predicate<T> is a delegate to a method that returns true if the object passed to it matches the conditions defined in the delegate. Elementy array są indywidualnie przenoszone Predicate<T>do.The elements of array are individually passed to the Predicate<T>.

Ta metoda jest operacją on(), gdzie n is count.This method is an O(n) operation, where n is count.

Zobacz też

Dotyczy