indexof_regex()

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

Zwraca indeks zerowy pierwszego wystąpienia określonego wyrażenia regularnego wyszukiwania w ciągu wejściowym.

Zobacz: indexof().

Składnia

indexof_regex(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 wyszukiwania wyrażeń regularnych.
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.

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.

Uwaga

• Wyszukiwanie nakładających się dopasowań nie jest obsługiwane.
• Ciągi wyrażeń regularnych mogą zawierać znaki, które wymagają ucieczki lub używania @'' literałów ciągu.

Przykłady

Uruchamianie zapytania

print
    idx1 = indexof_regex("abcabc", @"a.c"), // lookup found in input string
    idx2 = indexof_regex("abcabcdefg", @"a.c", 0, 9, 2),  // lookup found in input string
    idx3 = indexof_regex("abcabc", @"a.c", 1, -1, 2),  // there's no second occurrence in the search range
    idx4 = indexof_regex("ababaa", @"a.a", 0, -1, 2), // Matches don't overlap so full lookup can't be found 
    idx5 = indexof_regex("abcabc", @"a|ab", -1)  // invalid start argument

Wyjście

idx1	idx2	idx3	idx4	idx5
0	3	-1	-1