indexof()

Raportuje indeks oparty na zerowym pierwszym wystąpieniu określonego ciągu w ciągu wejściowym.

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

Składnia

indexof(Ciąg,Mecz[,Uruchomić[,Długość[,Wystąpienia]]])

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa	Typ	Wymagane	Opis
ciąg	string	✔️	Ciąg źródłowy do wyszukania.
Mecz	string	✔️	Ciąg, dla którego mają być wyszukiwane.
Uruchomić	int		Pozycja początkowa wyszukiwania. Wartość ujemna spowoduje przesunięcie pozycji wyszukiwania początkowego z końca ciągu przez następujące wiele kroków: abs(początek).
length	int		Liczba pozycji znaku do zbadania. Wartość -1 oznacza nieograniczoną długość.
Wystąpienia	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 zera.

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

Przykłady

Uruchamianie zapytania

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

Dane wyjściowe

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