CKTIS / C#
Array.IndexOf — Index des ersten Vorkommens
System.Array.IndexOf findet das erste Vorkommen eines Werts in einem Array oder einem Bereich und gibt dessen Index zurück.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Array.IndexOf<T>(T[] array, T value)
Array.IndexOf<T>(T[] array, T value, int startIndex)
Array.IndexOf<T>(T[] array, T value, int startIndex, int count)System.Array.IndexOf durchsucht ein eindimensionales Array. Generische Überladungen geben einen nullbasierten Index zurück oder -1, wenn kein Treffer vorliegt.
startIndex legt den Beginn des Bereichs fest; count gibt dessen Länge an. Das Ergebnis bezieht sich auf das ursprüngliche Array. Verglichen wird mit EqualityComparer<T>.Default; die Suche hat für den durchsuchten Bereich eine Komplexität von O(n).
Bei einem null-Array wird ArgumentNullException ausgelöst, bei einem ungültigen Bereich ArgumentOutOfRangeException. Nicht generische Überladungen akzeptieren Array und object?; bei mehrdimensionalen Arrays lösen sie RankException aus. Ihr Rückgabewert bei fehlendem Treffer ist die untere Arraygrenze minus eins, üblicherweise -1.
Beispiele
using System;
int[] values = { 7, 4, 7, 9 };
Console.WriteLine(Array.IndexOf(values, 7));
Console.WriteLine(Array.IndexOf(values, 7, 1));
Console.WriteLine(Array.IndexOf(values, 7, 1, 1));Ergebnis
0 2 -1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.