Freigeben über


indexof()

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

Meldet den nullbasierten Index des ersten Vorkommens einer angegebenen Zeichenfolge innerhalb der Eingabezeichenfolge.

Weitere Informationen finden Sie unter indexof_regex().

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
string string ✔️ Die zu suchende Quellzeichenfolge.
match string ✔️ Die Zeichenfolge, nach der gesucht werden soll.
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.

Hinweis

Wenn Zeichenfolge oder Übereinstimmung nicht vom Typ stringist, wandelt die Funktion ihren Wert forcibly in string.

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.

Beispiele

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

Output

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