Condividi tramite

indexof()

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

Restituisce l'indice in base zero della prima occorrenza di una stringa specificata all'interno della stringa di input.

Per ulteriori informazioni, vedere indexof_regex().

Sintassi

indexof(occorrenza della lunghezza iniziale[,della corrispondenza[,di stringa,[,]]])

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
string string ✔️ Stringa di origine da cercare.
match string ✔️ Stringa in cui eseguire la ricerca.
start int Posizione iniziale della ricerca. Un valore negativo sfalserà la posizione di ricerca iniziale dalla fine della stringa in base a questo numero di passaggi:abs( start).
length int Numero di posizioni dei caratteri da esaminare. Il valore -1 indica una lunghezza illimitata.
occurrence int Numero dell'occorrenza. Il valore predefinito è 1.

Nota

Se la stringa o la corrispondenza non è di tipo string, la funzione esegue forzatamente il cast del valore su string.

Valori restituiti

Posizione dell'indice in base zero di corrispondenza.

  • Restituisce -1 se la corrispondenza non viene trovata nella stringa.
  • Restituisce null se:
    • start è minore di 0.
    • l'occorrenza è minore di 0.
    • la lunghezza è minore di -1.

Esempi

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

Output

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