Regex Project: regex.visit



	Regex Home Download Documentation Regex Verbs regex.compile regex.easyMatch regex.easySearch regex.extract regex.free regex.grep regex.init regex.join regex.match regex.quoteRE regex.search regex.split regex.subst regex.visit MatchInfo Table Metacharacters Pointers Credits

regex.visit

Syntax	regex.visit (pattern, adrObject, callBack, caseSensitive, makeGroups, maxRuns)
Params	pattern is a regular expression (string) adrString is the address of a string callBack is the address of a callback script caseSensitive is an optional boolean flag. Default is false. makeGroups is an optional boolean flag. Default is false. maxRuns an optional integer. Default is infinity.
Action	Traverses all matches of the regular expression in string pointed to by adrString.
Returns	True.
Examples	`local (test = " <A href='index.html'> <A href='index2.html'>") on testCallback (adrTable) dialog.notify (string(adrTable^)); return (true) regex.visit ("<([^>]+)>", @test, @testCallback) » true`
Notes	For each match, the callback script is called with the address of the matchInfo table as a parameter. The callback script can only return true or false. If true is returned, searching for more matches continues. If false is returned, the search for further mathces halts. If makeGroups is true, information about the group matches (such as offset, length and the matching strings) will be included in matchInfo table. maxRuns is the maximum number of searches that will be performed. The MatchInfo Table outlines the information optionally returned in the table pointed to by adrTable.

[ Previous ] [ Next ] To the top

Send questions and comments to regex@lists.scriptmeridian.org.
Page last updated: Thu, 10 Dec 1998 22:00:18 GMT.