murex rocks

Welcome

About

Install

Change Log

Blog

Technical Docs

Language Tour

Interactive Shell

Rosetta Stone

User Guide

Open Source

Discuss

Contribute

Source Code

Search Site

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

See Also

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

---

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