índice de()

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. La función indexof() distingue mayúsculas de minúsculas. Para realizar una búsqueda que no distingue mayúsculas de minúsculas, considere la posibilidad de usar tolower() o toupper() en ambas entradas.

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

Sintaxis

indexof( coincidencia de cadena,repetición de longitud[,[,

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción
cadena	string	✔️	Cadena de origen que se va a buscar.
Match	string	✔️	Cadena para la que se va a buscar.
iniciar	int		Posición de inicio de búsqueda. Un valor negativo desplazará la posición de búsqueda inicial desde el final de la
largura	int		Número de posiciones de caracteres que se van a examinar. Un valor de -1 significa longitud ilimitada.
ocurrencia	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

Ejecución de la consulta

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