match.md

Match String (match)

Match an exact value in an array

Description

match takes input from stdin and returns any array items / lines which contain an exact match of the parameters supplied.

When multiple parameters are supplied they are concatenated into the search string and white space delimited. eg all three of the below are the same:

match "a b c"
match a\sb\sc
match a b c
match a    b    c

If you want to return everything except the search string then use !match

Usage

Match every occurrence of search string

<stdin> -> match search string -> <stdout>

Match everything except search string

<stdin> -> !match search string -> <stdout>

Examples

Return matched

Match Wed

» ja [Monday..Friday] -> match Wed
[
    "Wednesday"
]

Ignore matched

Match everything except Wed

» ja [Monday..Friday] -> !match Wed
[
    "Monday",
    "Tuesday",
    "Thursday",
    "Friday"
] 

Detail

match 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

• match
• !match
• list.str
• !list.str

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
• Prepend To List (prepend): Add data to the start of an array
• Prettify JSON: Prettifies JSON to make it human readable
• Regex Operations (regexp): Regexp tools for arrays / lists of strings
• 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/match_doc.yaml.