RegexMatchCapturedStart

value RegexMatchCapturedStart ( value rxMatch, string/value strName/Index = 0 );

Rückgabewert

Rückgabewert	Beschreibung
Position	Die Startposition der Übereinstimmung in der Zeichenkette strSubject, die RegexMatch bzw. RegexGlobalMatch übergeben wurde.
-1	Für den Gruppennamen strName bzw. den Index gibt es keine Übereinstimmung oder der übergebene RegexMatch-Verweis rxMatch ist ungültig.

Parameter

rxMatch

Ein gültiger RegexMatch-Verweis, der das Ergebnis eines RegexMatch-, RegexIteratorNext- oder RegexIteratorPeekNext-Aufrufs enthält.

strName

Der Name der Gruppe, die eine Übereinstimmung hat. Hat diese Gruppe keine Übereinstimmung oder existiert diese Gruppe nicht so wird -1 zurückgegeben.

Index

Der Index 0 liefert immer das Gesamtübereinstimmungsergebnis (gilt auch für gruppenlose Filtermuster).
Besitzt das Filtermuster Gruppen, so kann eine Gruppe über den Index mit 1 beginnend ausgelesen werden.

Bemerkungen

Gibt die Startposition der Übereinstimmung in der Zeichenkette strSubject, die RegexMatch bzw. RegexGlobalMatch übergeben wurde, zurück (entsprechend der gewählten Gruppe an der n-ten Stelle Index bzw. mit dem entsprechenden Gruppenname strName).

Beispiel

value rxPattern, rxMatch;
string strLastError;
value StartPos, Length, EndPos;

//Zusammenhängende numerische Zeichenfolgen erfassen
if (! RegexCreate (rxPattern, "\\d+")) 
    RegexGetLastError (strLastError);
end
RegexMatch (rxPattern, "abc18def", rxMatch); //sucht nach der ersten Übereinstimmung

StartPos = RegexMatchCapturedStart (rxMatch);  //StartPos == 3
Length   = RegexMatchCapturedLength (rxMatch); //Length == 2
EndPos   = RegexMatchCapturedEnd (rxMatch);    //EndPos == 5
 

Die Regex-Funktionen

Siehe auch RegexCreate, RegexGetLastError, RegexMatch,  RegexMatchCapturedStart, RegexMatchCapturedLength, RegexMatchCapturedEnd