Udostępnij przez


indexOf()

Dotyczy: ✅Microsoft Fabric

Raportuje indeks zerowy pierwszego wystąpienia określonego ciągu w ciągu wejściowym. Funkcja indexof() uwzględnia wielkość liter. Aby przeprowadzić wyszukiwanie bez uwzględniania wielkości liter, rozważ użycie tolower() obu danych wejściowych lub toupper() na obu tych danych wejściowych.

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 Typ Wymagania opis
ciąg string ✔️ Ciąg źródłowy do wyszukania.
zapałka string ✔️ Ciąg, dla którego ma być wyszukiwane.
początek int Pozycja rozpoczęcia wyszukiwania. Wartość ujemna spowoduje przesunięcie początkowej pozycji wyszukiwania od końca
długości 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 powiedział: Identyfikator IDX2 Identyfikator IDX3 Identyfikator IDX4 Identyfikator IDX5 Identyfikator IDX6 Identyfikator IDX7 Identyfikator IDX8 Identyfikator IDX9
2 2 -1 -1 2 4 2 9 -1