array_index_of()

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

Sintaxis

array_index_of(valor de matriz, [ start [,, length [, occurrence ]]])

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

Parámetros

Nombre	Type	Obligatorio	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() pasos iniciales.
length	int		Número de valores que se van a examinar. Un valor de -1 significa longitud ilimitada.
occurrence	int		Número de repetición. El valor predeterminado es 1.

Devoluciones

Devuelve una posición de índice de base cero de búsqueda. Devuelve -1 si el valor no se encuentra en la matriz. Devuelve null para las 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.