Exportieren (0) Drucken
Alle erweitern

Array.FindLastIndex (generische Methode) (T[], Int32, Int32, Predicate (generisch))

Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.

Sucht nach einem Element, das die durch das angegebene Prädikat definierten Bedingungen erfüllt, und gibt den nullbasierten Index des ersten Vorkommens innerhalb des Bereichs von Elementen im Array zurück, der die angegebene Anzahl von Elementen umfasst und am angegebenen Index endet.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public static int FindLastIndex<T> (
	T[] array,
	int startIndex,
	int count,
	Predicate<T> match
)
J# unterstützt die Verwendung von generischen Typen und Methoden, aber nicht die Deklaration von neuen generischen Typen oder Methoden.
JScript unterstützt keine generischen Typen oder Methoden.

Typparameter

T

Der Typ der Elemente des Arrays.

Parameter

array

Das zu durchsuchende eindimensionale und nullbasierte Array.

startIndex

Der nullbasierte Startindex für die Rückwärtssuche.

count

Die Anzahl der Elemente im zu durchsuchenden Abschnitt.

match

Das Predicate, das die Bedingungen für das Element definiert, nach dem gesucht werden soll.

Rückgabewert

Der nullbasierte Index des letzten Vorkommnisses eines Elements, das mit den durch match definierten Bedingungen übereinstimmt, sofern gefunden, andernfalls –1.

AusnahmetypBedingung

ArgumentNullException

array ist NULL (Nothing in Visual Basic).

- oder -

match ist NULL (Nothing in Visual Basic).

ArgumentOutOfRangeException

startIndex liegt außerhalb des Bereichs der gültigen Indizes für array.

- oder -

count ist kleiner als 0.

- oder -

startIndex und count geben keinen gültigen Abschnitt in array an.

Die Array wird rückwärts durchsucht, wobei die Suche bei startIndex beginnt und bei startIndex minus count plus 1 beendet wird, wenn count größer als 0 ist.

Predicate ist ein Delegat für eine Methode, die true zurückgibt, wenn das übergebene Objekt die im Delegaten definierten Bedingungen erfüllt. Die Elemente von array werden einzeln an Predicate übergeben.

Diese Methode ist ein O(n)-Vorgang, wobei ncount ist.

Im folgenden Codebeispiel werden alle drei Überladungen der generischen FindLastIndex-Methode veranschaulicht. Es wird ein Array von Zeichenfolgen erstellt, das acht Dinosauriernamen enthält, von denen zwei (an Position 1 und 5) mit "saurus" enden. Im Codebeispiel wird außerdem die Suchprädikatmethode EndsWithSaurus definiert, die einen Zeichenfolgenparameter akzeptiert und einen booleschen Wert zurückgibt, mit dem angegeben wird, ob die Eingabezeichenfolge auf "saurus" endet.

Die FindLastIndex(J[],Predicate (generisch))-Methodenüberladung durchläuft das Array ausgehend vom Ende rückwärts und übergibt die einzelnen Elemente an die EndsWithSaurus-Methode. Die Suche wird angehalten, sobald die EndsWithSaurus-Methode für das Element an Position 5 true zurückgibt.

HinweisHinweis

In C# und Visual Basic muss der Predicate<string>-Delegat (Predicate(Of String) in Visual Basic) nicht explizit erstellt werden. Diese Sprachen leiten den richtigen Delegaten aus dem Kontext ab und erstellen ihn automatisch.

Mit der FindLastIndex(J[],Int32,Predicate (generisch))-Methodenüberladung wird das Array ab Position 4 rückwärts bis zum Anfang des Arrays durchsucht. Sie findet das Element an Position 1. Schließlich wird mithilfe der FindLastIndex(J[],Int32,Int32,Predicate (generisch))-Methodenüberladung der Bereich mit drei Elementen ab Position 4 rückwärts durchsucht (d. h. die Elemente 4, 3 und 2). Es wird -1 zurückgegeben, da in diesem Bereich keine Dinosauriernamen enthalten sind, die auf "saurus" enden.

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.FindLastIndex(dinosaurs, EndsWithSaurus): {0}", 
            Array.FindLastIndex(dinosaurs, EndsWithSaurus));

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

        Console.WriteLine(
            "\nArray.FindLastIndex(dinosaurs, 4, 3, EndsWithSaurus): {0}",
            Array.FindLastIndex(dinosaurs, 4, 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.FindLastIndex(dinosaurs, EndsWithSaurus): 5

Array.FindLastIndex(dinosaurs, 4, EndsWithSaurus): 1

Array.FindLastIndex(dinosaurs, 4, 3, EndsWithSaurus): -1
 */

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Anzeigen:
© 2015 Microsoft