RegexMatch

Overview

The RegexMatch Block performs regex-based pattern matching on a string input. It applies the provided regex expression to the input string and returns a list of all matches found. If no matches are found, the Block returns ["No match found"].

This Block is useful for extracting data based on specific patterns in strings, such as emails, phone numbers, or other formats.

Description

regex-based pattern matching on a string input, returning a list of all matches found.

Metadata

• Category: Function

Configuration Options

Name	Data Type	Description	Default Value
regex	str		.*

Inputs

Name	Data Type	Description
input_strings	str

Outputs

Name	Data Type	Description
result	list[str]

State Variables

No state variables available.

Example(s)

Example 1: Find all numbers in a string

• Create a RegexMatch Block.
• Set the regex to \d+ (this regex matches one or more digits).
• Provide the input string: "My phone number is 12345 and my zip code is 67890."
• The Block will output: ["12345", "67890"].

Example 2: Match words starting with a specific letter

• Set up a RegexMatch Block.
• Set the regex to \b[Aa]\w* (this regex matches words starting with "A" or "a").
• Provide the input string: "Alice and Bob are attending the event."
• The Block will output: ["Alice", "and", "are"].

Example 3: No matches found

• Create a RegexMatch Block.
• Set the regex to \d+ (this regex matches digits).
• Provide the input string: "No numbers here."
• The Block will output: ["No match found"] as there are no digits in the string.

Example 4: Handle regex errors

• Create a RegexMatch Block.
• Set an invalid regex, such as \d++.
• The Block will return an error message like ["Error: nothing to repeat at position 3"].

Error Handling

• If the regex pattern is invalid, the Block will return a list containing an error message with the exception details.
• If no matches are found, the Block will return ["No match found"].

FAQ

What happens if the regex pattern is invalid?

If the provided regex pattern is invalid, the Block will catch the exception and return a list containing the error message. This allows you to handle regex-related errors gracefully.

Can I use this Block for complex regex patterns?

Yes, the RegexMatch Block supports any valid regex pattern, allowing you to handle complex string matching tasks such as extracting specific formats or patterns from text.

What if the input string contains no matches?

If the input string does not match the provided regex pattern, the Block will return ["No match found"].

Does this Block support multiline input?

Yes, the Block can handle multiline input, but you'll need to adjust the regex pattern accordingly (e.g., use re.MULTILINE or include newline characters in the regex if needed).