array_index_of()

Busca en una matriz el elemento especificado y devuelve su posición.

Syntax

array_index_of(Matriz,value [start [,,length [,occurrence ]]])

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
array	dynamic	✔️	Matriz que se va a buscar.
value	long, int, datetime, timespan, string, guid o bool	✔️	Valor que se va a buscar.
start	int		Posición de inicio de búsqueda. Un valor negativo desplazará el valor de búsqueda inicial desde el final de la matriz por abs( los pasos iniciales).
length	int		Número de valores que se van a examinar. Un valor de -1 significa una longitud ilimitada.
occurrence	int		Número de la repetición. El valor predeterminado es 1.

Devoluciones

Devuelve una posición de índice de base cero de la búsqueda. Devuelve -1 si el valor no se encuentra en la matriz. Devuelve null para entradas irrelevantes (repetición< 0 o longitud< -1).

Ejemplo

En el ejemplo siguiente se muestra el número de posición de palabras específicas dentro de la matriz.

Ejecución de la consulta

let arr=dynamic(["this", "is", "an", "example", "an", "example"]);
print
 idx1 = array_index_of(arr,"an")    // lookup found in input string
 , idx2 = array_index_of(arr,"example",1,3) // lookup found in researched range 
 , idx3 = array_index_of(arr,"example",1,2) // search starts from index 1, but stops after 2 values, so lookup can't be found
 , idx4 = array_index_of(arr,"is",2,4) // search starts after occurrence of lookup
 , idx5 = array_index_of(arr,"example",2,-1)  // lookup found
 , idx6 = array_index_of(arr, "an", 1, -1, 2)   // second occurrence found in input range
 , idx7 = array_index_of(arr, "an", 1, -1, 3)   // no third occurrence in input array
 , idx8 = array_index_of(arr, "an", -3)   // negative start index will look at last 3 elements
 , idx9 = array_index_of(arr, "is", -4)   // negative start index will look at last 3 elements

Salida

idx1	idx2	idx3	idx4	idx5	idx6	idx7	idx8	idx9
2	3	-1	-1	3	4	-1	4	-1

Contenido relacionado

Use set_has_element(arr, value) para comprobar si existe un valor en una matriz. Esta función mejorará la legibilidad de la consulta. Ambas funciones tienen el mismo rendimiento.