RegexIteratorHasNext

value RegexIteratorHasNext ( value rxIterator );

Rückgabewert

Rückgabewert

Beschreibung

TRUE / true / 1

Ein RegexMatch-Verweis ist vorhanden.

FALSE / false / 0

Es gibt keinen bzw. keinen weiteren RegexMatch-Verweis.

Parameter

rxIterator

Ein gültiger RegexIterator-Verweis der überprüft werden soll, ob er einen bzw. einen weiteren RegexMatch-Verweise enthält. Ein gültiger RegexIterator-Verweis kann nur durch einen RegexGlobalMatch Aufruf erzeugt werden.

Bemerkungen

Prüft ob der gültige RegexIterator-Verweis rxIterator einen bzw. einen weiteren RegexMatch-Verweise enthält. Falls ein oder ein weiterer RegexMatch-Verweis enthalten ist, so kann dieser mit einem RegexIteratorNext ausgelesen werden. Durch diesen Auslesevorgang wird dieser RegexMatch-Verweis dann aus dem RegexIterator-Verweis rxIterator ausgetragen. Wird der RegexIterator-Verweis rxIterator durch nachfolgende RegexIteratorNext Aufrufe leer, gibt ein anschließender RegexIteratorHasNext Aufruf als Resultat FALSE zurück.

Beispiel

value rxPattern, rxMatch, rxIterator;
string strResult, strLastError;

//Zusammenhängende numerische Zeichenfolgen mit '°C' im Suffix erfassen und
//die numerischen Zeichenfolgen in der Gruppe 'temp' zusammenfassen.
if (! RegexCreate (rxPattern, "(?<temp>\\d+)°C")) 
    return (RegexGetLastError (strLastError));
end
RegexGlobalMatch (rxPattern, rxIterator, "123V 23A 345°C, 157V 43A 288°C");

while (RegexIteratorHasNext (rxIterator)) //ist eine weitere Übereinstimmung vorhanden?
    rxMatch = RegexIteratorNext (rxIterator); //nächste Übereinstimmung auslesen
    strResult += RegexMatchCaptured (rxMatch, "temp");
    strResult += "\n";
end 

Die Regex-Funktionen

Siehe auch RegexCreate, RegexSetPattern, RegexClose, RegexGetLastError, RegexGlobalMatch, RegexIteratorNext, RegexIteratorPeekNext