Condividi tramite


indexOf()

Si applica a: ✅Microsoft Fabric

Restituisce l'indice in base zero della prima occorrenza di una stringa specificata all'interno della stringa di input. La funzione indexof() fa distinzione tra maiuscole e minuscole. Per eseguire una ricerca senza distinzione tra maiuscole e minuscole, è consigliabile usare tolower() o toupper() su entrambi gli input.

Per ulteriori informazioni, vedere indexof_regex().

Sintassi

indexof( occorrenza della lunghezza iniziale,[,[,

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
corda string ✔️ Stringa di origine da cercare.
fiammifero string ✔️ Stringa in cui eseguire la ricerca.
inizio int Posizione iniziale della ricerca. Un valore negativo sfalserà la posizione di ricerca iniziale dalla fine della
lunghezza int Numero di posizioni dei caratteri da esaminare. Il valore -1 indica una lunghezza illimitata.
evento 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

Risultato

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