Regex Operations (regexp)

Regexp tools for arrays / lists of strings

Description

regexp provides a few tools for text matching and manipulation against an array or list of strings - thus regexp is Murex data-type aware.

Usage

<stdin> -> regexp expression -> <stdout>

Examples

Find elements

» ja [monday..sunday] -> regexp 'f/^([a-z]{3})day/'
[
    "mon",
    "fri",
    "sun"
]

This returns only 3 days because only 3 days match the expression (where the days have to be 6 characters long) and then it only returns the first 3 characters because those are inside the parenthesis.

Match elements

Elements containing

» ja [monday..sunday] -> regexp 'm/(mon|fri|sun)day/'
[
    "monday",
    "friday",
    "sunday"
]

Elements excluding

» ja [monday..sunday] -> !regexp 'm/(mon|fri|sun)day/'
[
    "tuesday",
    "wednesday",
    "thursday",
    "saturday"
]

Substitute expression

» ja [monday..sunday] -> regexp 's/day/night/'
[
    "monnight",
    "tuesnight",
    "wednesnight",
    "thursnight",
    "frinight",
    "saturnight",
    "sunnight"
]

Flags

• f output found expressions (doesn't support bang prefix)
• m output elements that match expression (supports bang prefix)
• s output all elements - substituting elements that match expression (doesn't support bang prefix)

Detail

regexp is data-type aware so will work against lists or arrays of whichever Murex data-type is passed to it via stdin and return the output in the same data-type.

Synonyms

• regexp
• !regexp
• list.regex
• !list.regex

See Also

• Add Prefix (prefix): Prefix a string to every item in a list
• Add Suffix (suffix): Prefix a string to every item in a list
• Append To List (append): Add data to the end of an array
• Count (count): Count items in a map, list or array
• Create 2d Array (2darray): Create a 2D JSON array from multiple input sources
• Create JSON Array (ja): A sophisticated yet simply way to build a JSON array
• Create Map (map): Creates a map from two data sources
• Create New Array (ta): A sophisticated yet simple way to build an array of a user defined data-type
• Match String (match): Match an exact value in an array
• Prepend To List (prepend): Add data to the start of an array
• Prettify JSON: Prettifies JSON to make it human readable
• Sort Array (msort): Sorts an array - data type agnostic
• Split String (jsplit): Splits stdin into a JSON array based on a regex parameter
• Stream New List (a): A sophisticated yet simple way to stream an array or list (mkarray)

---

This document was generated from builtins/core/lists/regexp_doc.yaml.