Udostępnij za pośrednictwem

indexof()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Raportuje indeks zerowy pierwszego wystąpienia określonego ciągu w ciągu wejściowym.

Aby uzyskać więcej informacji, zobacz indexof_regex().

Składnia

indexof(ciąg,pasuje do[,wystąpienia długości początkowej[,[,]]])

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
string string ✔️ Ciąg źródłowy do wyszukania.
match string ✔️ Ciąg, dla którego ma być wyszukiwane.
start int Pozycja rozpoczęcia wyszukiwania. Wartość ujemna spowoduje przesunięcie początkowej pozycji wyszukiwania od końca ciągu przez następujące wiele kroków: abs(rozpoczęcie).
length int Liczba pozycji znaku do zbadania. Wartość -1 oznacza nieograniczoną długość.
zdarzenie int Liczba wystąpień. Wartość domyślna to 1.

Uwaga

Jeśli ciąg lub dopasowanie nie jest typu string, funkcja wymusza rzutowanie ich wartości na string.

Zwraca

Położenie indeksu opartego na zerach.

  • Zwraca wartość -1, jeśli dopasowanie nie zostanie znalezione w ciągu.
  • Zwraca wartość null if:
    • wartość początkowa jest mniejsza niż 0.
    • wystąpienie jest mniejsze niż 0.
    • długość jest mniejsza niż -1.

Przykłady

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

Wyjście

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