indexof()
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 string
ist, 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 |