Regexp
Description
Searches a set string or stream, using a pattern written according to the rules of the regular expression syntax.
Properties
Specific
-
Pattern
EXPRESSION (string)
-
Regular expression used for searching.
-
Text
EXPRESSION (string)
-
The text to be searched can be a string or a stream.
-
Global
EXPRESSION (boolean)
-
This option determines whether only the first occurrence of the pattern or every occurrence of the pattern is searched.
-
Case insensitive
EXPRESSION (boolean)
-
This option determines whether the search will be case sensitive or not.
General
-
Description
String
-
This is the description of the Action component. Description is displayed below the component in the Project editor/viewer. In the main toolbar, it is possible to hide or display descriptions of all components with one click.
Flow
-
Inputs
Array
-
Additional component inputs that the user can add as desired in order to use them to receive additional data needed when evaluating expressions in properties. Each input is given a name and type. Name is used when referencing an input within an expression. A type is used to project Check to check whether a data line that transmits data of that type is connected to the input or not.
-
Outputs
Array
-
Additional component outputs that the user can add to send data through. Each output is assigned a name and type. An example of using this output is e.g. in the Loop component, where we can put the output name for the
Variableproperty instead of e.g. variable name. In that case, the Loop component will not change the content of the variable in each step, but will send the current value through that output. -
Catch error
Boolean
-
If this checkbox is enabled then an
@Erroroutput will be added to the component and if an error occurs in this component during the execution of the Flow, the Flow will continue through that output. The data that will be passed through that output is the textual description of the error.
Position and size
-
Align and distribute
Any
-
Alignment icons and component distribution. Alignment icons appear when two or more components are selected, and distribution icons appear when three or more components are selected.
Inputs
-
seqin
SEQ | OPTIONAL
-
A standard sequence input. This input needs to be used once at the beginning.
-
next
SEQ | OPTIONAL
-
Use this input to get the next match.
-
stop
SEQ | OPTIONAL
-
Use this input when we want to stop further searching, after which the Flow execution will immediately continue through the
doneoutput.
Outputs
-
seqout
SEQ | OPTIONAL
-
A standard sequence output.
-
match
DATA(struct:$RegExpResult) | MANDATORY
-
Search match in the form of
struct:$RegexpMatchvalue is sent through this output. The$RegexpMatchstructure has the following fields:index(integer) – The 0-based index of the match in the string.texts(array:string) – The array that has the matched text as the first item, and then one item for each capturing group of the matched text.indices(array:array:integer) – It is an array where each entry represents the bounds of a substring match. The index of each element in this array corresponds to the index of the respective substring match in thetextsarray. In other words, the first indices entry represents the entire match, the second indices entry represents the first capturing group, etc. Each entry itself is a two-element array, where the first number represents the match’s start index, and the second number, its end index.
-
done
DATA(string) | OPTIONAL
-
Flow execution continues through this output when the search is complete, i.e. there are no more matches.
Examples
- RegExp String
- RegExp Stream