Differences

This shows you the differences between two versions of the page.

--- syntax:functions:regexmatch [2020/11/26 17:45] – created dmitry
+++ syntax:functions:regexmatch [2022/05/20 06:54] (current) – dmitry
@@ Line 1: / Line 1: @@
-===== RegexMatch(text, regex_text) =====
+====== RegExMatch(text, regex_text) ======
+Category:  Text function
-Returns the first substring that matches the regular expression pattern.
+\\
+=====Description=====
+This function returns the first substring that matches the regular expression pattern //regex_text//.
-^  Example  ^  Result  ^
+\\
-| regexmatch('12345678', '%%^%%\d{4}')  |1234 |
+=====Use cases=====
+//RegExMatch// is useful for fuzzy-matching and extracting substrings of text using a specific pattern of characters.
-** See also **
+\\
+=====Arguments=====
+^Argument^Type^Description^
+|text|Text|The text value to test for the //regex_text// RegEx pattern.|
+|regex_text|Text (RegEx pattern)|The string pattern to search for within //text//.  The first instance of text matching this pattern is returned.|
-  * [[syntax:functions:isregexmatch]]
+**Return value type:** Text
-  * [[syntax:functions:regexreplace]]
+\\
+=====Remarks=====
+EasyMorph uses the [[https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference|.NET regex language]].
+\\
+=====Examples=====
+  regexmatch('12345678', '^\d{4}') //Returns '1234'
+  regexmatch('MaryAnne', '[a-zA-z]{4}) //Returns 'Mary'
+\\
+===== See also =====
+  * [[syntax:functions:isregexmatch|IsRegExMatch(text, regex_text)]]
+  * [[syntax:functions:regexreplace|RegexReplace(text, replace_text, regex_text)]]