Loading...
The RegEx Text Filter node extends the "Find and Replace" feature known from common text editor software with RegEx expressions. A Regular Expression (short: RegEx) is a pattern that describes a certain combination / amount of text including word, number and (non-) printable characters. By supporting character classes (wild cards), grouping, back-references, etc. the RegEx engine allows very flexible and efficient text processing.
There are different RegEx flavors i.e. implementations in various programming languages. Widget Designer uses the RegEx the .NET framework library.
Below you will find a few examples how regular expressions work. For further information and complete description of supported character classes, operators and constructs, please visit:
https://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.110%29.aspx
Note: The Filter node "RegEx Compare" also searches for text that matches the used RegEx but does not replace it, it simply returns a TRUE or FALSE.
The node can be found under Nodes > Filter Nodes > Text > RegEx Text
Input:
Choose an input node from the drop-down or enter a text.
Pattern:
Enter a regular expression describing the text you want to search for.
Replacement:
Enter a regular expression that should replace a found pattern.
With Widget Designer version 6, all nodes support so called node commands. Node commands access functions (i.e methods) from a node and / or set a parameter (i.e. property).
Enter "node", followed by the according ID and a dot and a list will pop up showing all available commands for the node. For instance, Node1.TintColor.SetRGB(125,0,255), colors the node in purple.
In addition, the node properties with a parameter ID (the small superscript number) can be edited via the command Node1.SetParam(ID,new Value) or WDNodeSetParam(NodeID,ParamID,Value).
The Node generates the following output:
- Output
These examples are based on the input string:
A cat wears 99 hats - What? - Yes, yes!
Pattern |
Replace |
Output |
Meaning |
---|---|---|---|
[a-z]+ |
1 |
A 1 1 99 1 - W1? - Y1, 1! |
Searches case-sensitive any letter from character group "a-z" that occurs at least once. Replaces with digit "1" |
(cat)[^\?]* |
$1 |
A cat? - Yes, yes! |
Searches for a string that starts with "cat" followed by any character that is not a "?" occurring zero or more times. By putting "cat" in round brackets, it becomes group no.1. Replaces with first group. |
[^a-zA-Z0-9 ] |
|
A cat wears 22 hats What Yes yes |
Searches for any character that is not a-z nor A-Z nor 0-9 nor a space. Replaces with nothing (i.e. it's erased). |
[^\w] |
|||
\W |
|||
(?i)yes |
yes |
A cat wears 22 hats - What? - yes, yes! |
Searches case-insensitive for the word "yes". Replaces with "yes". |
For further information and complete description please visit:
https://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.110%29.aspx