Compartir a través de

indexof()

  • Artículo

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

Informa del índice de base cero de la primera aparición de una cadena especificada dentro de la cadena de entrada.

Para obtener más información, vea indexof_regex().

Sintaxis

indexof(coincidencia de cadena,:[,repetición de longitud[,de inicio[,]]])

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

Parámetros

Nombre Type Obligatorio Description
string string ✔️ Cadena de origen que se va a buscar.
Match string ✔️ Cadena para la que se va a buscar.
start int Posición de inicio de búsqueda. Un valor negativo desplazará la posición de búsqueda inicial desde el final de la cadena por estos muchos pasos: abs(iniciar).
length int Número de posiciones de caracteres que se van a examinar. Un valor de -1 significa longitud ilimitada.
occurrence int Número de repetición. El valor predeterminado es 1.

Nota:

Si la cadena o la coincidencia no son de tipo string, la función convierte forzosamente su valor en string.

Devoluciones

Posición de índice de base cero de coincidencia.

  • Devuelve -1 si no se encuentra la coincidencia en la cadena.
  • Devuelve null si:
    • start es menor que 0.
    • la repetición es menor que 0.
    • length es menor que -1.

Ejemplos

print
 idx1 = indexof("abcdefg","cde")    // lookup found in input string
 , idx2 = indexof("abcdefg","cde",1,4) // lookup found in researched range 
 , idx3 = indexof("abcdefg","cde",1,2) // search starts from index 1, but stops after 2 chars, so full lookup can't be found
 , idx4 = indexof("abcdefg","cde",3,4) // search starts after occurrence of lookup
 , idx5 = indexof("abcdefg","cde",-5)  // negative start index
 , idx6 = indexof(1234567,5,1,4)       // two first parameters were forcibly casted to strings "12345" and "5"
 , idx7 = indexof("abcdefg","cde",2,-1)  // lookup found in input string
 , idx8 = indexof("abcdefgabcdefg", "cde", 1, 10, 2)   // lookup found in input range
 , idx9 = indexof("abcdefgabcdefg", "cde", 1, -1, 3)   // the third occurrence of lookup is not in researched range

Salida

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