Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

Array.IndexOf — índice de la primera aparición

System.Array.IndexOf busca la primera aparición de un valor en una matriz o en un rango y devuelve su índice.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

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 busca en una matriz unidimensional. Las sobrecargas genéricas devuelven un índice basado en cero o -1 si no hay ninguna coincidencia.

startIndex indica el comienzo del rango; count especifica su longitud. El resultado es un índice de la matriz original. La igualdad utiliza EqualityComparer<T>.Default; la búsqueda tiene una complejidad O(n) en el rango buscado.

Si la matriz es null, se produce ArgumentNullException; si el rango no es válido, se produce ArgumentOutOfRangeException. Las sobrecargas no genéricas aceptan Array y object?; las matrices multidimensionales provocan RankException. Si no hay coincidencia, el resultado es el límite inferior de la matriz menos uno, normalmente -1.

Ejemplos

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

Resultado

0
2
-1

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes