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

Array Sort: msort

Sorts an array - data type agnostic

Description

This builtin takes input from stdin, sorts it and the outputs it to stdout.

The code behind msort is significantly more lightweight than UNIX sort. It doesn’t work with numeric types (eg sorting floating point numbers), reversed order nor multi-column data. It is specifically designed to work with lists of data. For example arrays in data formats like JSON (json), YAML (yaml) or S-Expressions (sexp); or lists of strings (str). The intention is to cover use cases not already covered by UNIX sort while also providing something rudimentary for Murex scripts to function on Windows without having to write lots of ugly platform-specific code. This is also the reason this builtin is called msort rather than conflicting with the existing UNIX name, sort.

Usage

<stdin> -> msort -> <stdout>

Examples

» tout json (["c", "b", "a"]) -> msort   
[
    "a",
    "b",
    "c"
]

Since msort does not support reversed order, you will need to pipe the output of msort into another builtin:

» tout json (["c", "b", "a"]) -> msort -> mtac 
[
    "c",
    "b",
    "a"
]

Synonyms

• msort
• list.sort

See Also

• Alter Data Structure: alter, ~>: Change a value within a structured data-type and pass that change along the pipeline without altering the original source input
• Array Append: append: Add data to the end of an array
• Array Prepend: prepend: Add data to the start of an array
• Array Reverse: mtac: Reverse the order of an array
• Count: count: Count items in a map, list or array
• Create JSON Array: ja: A sophisticated yet simply way to build a JSON array
• Create Streamable Array: a: A sophisticated yet simple way to stream an array or list (mkarray)
• Filter By Range: [ ..Range ]: Outputs a ranged subset of data from stdin
• Get Item Property: [ Index ]: Outputs an element from an array, map or table
• Get Nested Element: [[ Element ]]: Outputs an element from a nested structure
• String Split: jsplit: Splits stdin into a JSON array based on a regex parameter

---

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