Freigeben über


indexof_regex()

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Gibt den nullbasierten Index des ersten Vorkommens eines angegebenen regulären Nachschlageausdrucks innerhalb der Eingabezeichenfolge zurück.

Siehe indexof().

Syntax

indexof_regex(Zeichenfolgen-Übereinstimmung,[,Startlänge Vorkommen[,[,]]])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
string string ✔️ Die zu suchende Quellzeichenfolge.
match string ✔️ Die Nachschlagezeichenfolge für reguläre Ausdrücke .
start int Die Startposition der Suche. Ein negativer Wert versetzt die Anfangssuchposition vom Ende der Zeichenfolge bis zu diesen vielen Schritten: abs("Start").
length int Die Anzahl der zu überprüfenden Zeichenpositionen. Ein Wert von -1 bedeutet eine unbegrenzte Länge.
occurrence int Die Nummer des Vorkommens. Der Standardwert ist 1.

Gibt zurück

Die nullbasierte Indexposition der Übereinstimmung.

  • Gibt -1 zurück, wenn die Übereinstimmung nicht in einer Zeichenfolge gefunden wird.
  • Gibt zurück null , wenn:
    • Start ist kleiner als 0.
    • Das Vorkommen ist kleiner als 0.
    • Die Länge ist kleiner als -1.

Hinweis

  • Überlappende Übereinstimmungen werden nicht unterstützt.
  • Reguläre Ausdruckszeichenfolgen können Zeichen enthalten, die entweder escapen oder Zeichenfolgenliterale verwenden @'' müssen.

Beispiele

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

Output

idx1 idx2 idx3 idx4 idx5
0 3 -1 -1