Regular Expressions - Revision history

Bale: fix wiki markup

2011-08-02T21:48:19Z

fix wiki markup

← Older revision		Revision as of 21:48, 2 August 2011
Line 120:		Line 120:

	Using regular expressions in ash follows this basic formula:		Using regular expressions in ash follows this basic formula:
	#First a regular expression needs to be defined with the [[matcher]] datatype. Defining a matcher also requires the use of the ~~[[create_matcher~~\|create_matcher~~()]]~~ function.		#First a regular expression needs to be defined with the [[matcher]] datatype. Defining a matcher also requires the use of the {{f\|create_matcher}} function.
	#:'''Important''': in ash backslashes have special meaning inside a string, so any backslashes need to be backslashed or else ash will interpret them differently.		#:'''Important''': in ash backslashes have special meaning inside a string, so any backslashes need to be backslashed or else ash will interpret them differently.
	#Then the matcher can be operated upon by the various [[String Handling Routines#Regular Expressions\|regex functions]], notably ~~[[find~~\|find~~()]]~~.		#Then the matcher can be operated upon by the various [[String Handling Routines#Regular Expressions\|regex functions]], notably {{f\|find}}.
	#Finally, if there were capturing groups in the matcher, they can be checked using the ~~[[group~~\|group~~()]]~~ function.		#Finally, if there were capturing groups in the matcher, they can be checked using the {{f\|group}} function.

	{{CodeSample\|		{{CodeSample\|

Slyz: removed an extra ')' in the example for a case-insensitive matcher

2010-11-09T16:31:52Z

removed an extra ')' in the example for a case-insensitive matcher

← Older revision		Revision as of 16:31, 9 November 2010
Line 104:		Line 104:

	Special quantifiers can be used in a standalone special group that has a length of 0.		Special quantifiers can be used in a standalone special group that has a length of 0.
	: E.g. {{Pspan\|(?i)hello)}} will match "{{Pspan\|HELLO}}", since {{Pspan\|(?i)}} tells the regex to ignore case.		: E.g. {{Pspan\|(?i)hello}} will match "{{Pspan\|HELLO}}", since {{Pspan\|(?i)}} tells the regex to ignore case.

	Negative/positive lookahead/lookbehind can help you finetune your regex by restricting what can appear without capturing more of the target string		Negative/positive lookahead/lookbehind can help you finetune your regex by restricting what can appear without capturing more of the target string

Heeheehee: Special groups! Okay, that might be a bit too complicated. =P

2010-08-26T13:25:24Z

Special groups! Okay, that might be a bit too complicated. =P

← Older revision		Revision as of 13:25, 26 August 2010
Line 97:		Line 97:
	: E.g. {{Pspan\|<.+?>}} will match "This is a {{Pspan\|<nowiki><b></nowiki>}}test<nowiki></b></nowiki>." so that you can pick out html tags.		: E.g. {{Pspan\|<.+?>}} will match "This is a {{Pspan\|<nowiki><b></nowiki>}}test<nowiki></b></nowiki>." so that you can pick out html tags.

			===Special Groups===
			These are special types of groups that can allow you to do more advanced things with regex. For the most part, they can be declared by adding a question mark to the beginning of a special group.

			Noncapturing groups are declared by adding a colon after the question mark.
			: E.g. {{Pspan\|(?:hello)}} will match "{{Pspan\|hello}}world" without actually creating a new capturing group.

			Special quantifiers can be used in a standalone special group that has a length of 0.
			: E.g. {{Pspan\|(?i)hello)}} will match "{{Pspan\|HELLO}}", since {{Pspan\|(?i)}} tells the regex to ignore case.

			Negative/positive lookahead/lookbehind can help you finetune your regex by restricting what can appear without capturing more of the target string
			: E.g. {{Pspan\|(?<!\\S)([\\d]+)(?!\\S)}} uses negative lookahead and negative lookbehind, and so it will only match a series of digits not bounded by non-space characters, which is to say, a series of digits bounded by spaces. Presumably it would be functionally identical to {{Pspan\|<nowiki>(?<=\\s)([\\d]+)(?=\\s)</nowiki>}}.

			Since ASH's regular expressions are directly passed to Java, ASH does not support named groups.

	===Testing Resources===		===Testing Resources===

Bale: This sometimes bedevils me. I figure it will bedevil others.

2010-08-26T03:19:17Z

This sometimes bedevils me. I figure it will bedevil others.

← Older revision		Revision as of 03:19, 26 August 2010
Line 88:		Line 88:
	\| Matches any single character, except for the range a-z or A-Z.		\| Matches any single character, except for the range a-z or A-Z.
	\|}		\|}


			===Greedy vs Lazy Matching===
			Beware greedy matching! Matchers that can match multiple tokens will attempt to match as much as possible.
			: E.g. {{Pspan\|<.+>}} will match "This is a {{Pspan\|<nowiki><b>test</b></nowiki>}}." instead of matching '''only''' the html tag as you might have expected.

			To fix this, you can make the match lazy, by adding a ? after the greedy character.
			: E.g. {{Pspan\|<.+?>}} will match "This is a {{Pspan\|<nowiki><b></nowiki>}}test<nowiki></b></nowiki>." so that you can pick out html tags.

67.116.252.153: /* Literal Characters */

2010-08-07T19:30:18Z

Literal Characters

← Older revision		Revision as of 19:30, 7 August 2010
Line 13:		Line 13:

	*E.g. {{Pspan\|a}} will match the first a in "J{{Pspan\|a}}ck is a dull boy."		*E.g. {{Pspan\|a}} will match the first a in "J{{Pspan\|a}}ck is a dull boy."
	*E.g. {{Pspan\|cat}} is a set of three literal character which will find a match in "about {{Pspan\|~~cats~~}} and dogs."		*E.g. {{Pspan\|cat}} is a set of three literal character which will find a match in "about {{Pspan\|cat}}s and dogs."


	===Special Characters===		===Special Characters===

Bale at 09:04, 17 July 2010

2010-07-17T09:04:01Z

← Older revision		Revision as of 09:04, 17 July 2010
Line 125:		Line 125:
	</syntaxhighlight>}}		</syntaxhighlight>}}

	[[Category:String Handling Routines]]\|[[Category:~~ASH~~ Scripting]]		[[Category:String Handling Routines]][[Category:Scripting]]

StDoodle: capitalization consistency

2010-07-05T06:51:41Z

capitalization consistency

← Older revision		Revision as of 06:51, 5 July 2010
Line 96:		Line 96:
	* [http://www.regexplanet.com/simple/ regexplanet.com]		* [http://www.regexplanet.com/simple/ regexplanet.com]

	==Using Regexes in ~~KolMafia~~==		==Using Regexes in KoLmafia==
	Regular expressions in ASH are wrappers for the Java java.util.regex package. You can find detailed information about that in this [http://java.sun.com/docs/books/tutorial/essential/regex/index.html Java Tutorial]. Only the highlights will be described in this section.		Regular expressions in ASH are wrappers for the Java java.util.regex package. You can find detailed information about that in this [http://java.sun.com/docs/books/tutorial/essential/regex/index.html Java Tutorial]. Only the highlights will be described in this section.

Bale: Let's simplify. I just didn't know that.

2010-06-22T21:22:04Z

Let's simplify. I just didn't know that.

← Older revision		Revision as of 21:22, 22 June 2010
Line 94:		Line 94:
	If you're not sure if your regex will work, try testing it with one of these resources:		If you're not sure if your regex will work, try testing it with one of these resources:
	* [http://gskinner.com/RegExr/ gskinner.com]		* [http://gskinner.com/RegExr/ gskinner.com]
	* ~~[http://www.fileformat.info/tool/regex.htm fileformat.info]~~		* [http://www.regexplanet.com/simple/ regexplanet.com]
	** The above page redirects to [http://www.regexplanet.com/simple/ regexplanet.com] ~~for processing requests; you can go directly there.~~

	==Using Regexes in KolMafia==		==Using Regexes in KolMafia==

PhilmASTErpLus: /* Testing Resources */ Added regexplanet.com

2010-06-22T11:57:20Z

Testing Resources: Added regexplanet.com

← Older revision		Revision as of 11:57, 22 June 2010
Line 95:		Line 95:
	* [http://gskinner.com/RegExr/ gskinner.com]		* [http://gskinner.com/RegExr/ gskinner.com]
	* [http://www.fileformat.info/tool/regex.htm fileformat.info]		* [http://www.fileformat.info/tool/regex.htm fileformat.info]
			** The above page redirects to [http://www.regexplanet.com/simple/ regexplanet.com] for processing requests; you can go directly there.

	==Using Regexes in KolMafia==		==Using Regexes in KolMafia==

Bale at 08:08, 21 May 2010

2010-05-21T08:08:50Z

← Older revision		Revision as of 08:08, 21 May 2010
Line 126:		Line 126:
	</syntaxhighlight>}}		</syntaxhighlight>}}

	[[Category:String Handling Routines]]		[[Category:String Handling Routines]]\|[[Category:ASH Scripting]]