murex Shell Docs

Command Reference: [[ (element)

Outputs an element from a nested structure

Description

Outputs an element from an array, map or table. Unlike index ([), element takes a path parameter which means it can work inside nested structures without pipelining multiple commands together. However this comes with the drawback that you can only return one element.

Element ([[) also doesn’t support the bang prefix (unlike) index.

Please note that indexes in murex are counted from zero.

Usage

<stdin> -> [[ element ]] -> <stdout>

$variable[[ element ]] -> <stdout>

Examples

Return the 2nd element in an array

» ja [0..9] -> [[ /1 ]]
[
    "1",
]

Return the data-type and description of config shell syntax-highlighting

» config -> [[ /shell/syntax-highlighting/Data-Type ]]
bool

Detail

Element counts from zero

Indexes in murex behave like any other computer array in that all arrays start from zero (0).

Alternative path separators

Element uses the first character in the path as the separator. So the following are all valid parameters:

» config -> [[ ,shell,syntax-highlighting,Data-Type ]]
bool

» config -> [[ >shell>syntax-highlighting>Data-Type ]]
bool

» config -> [[ \|shell\|syntax-highlighting\|Data-Type ]]
bool

» config -> [[ >shell>syntax-highlighting>Data-Type ]]
bool

However there are a few of caveats:

  1. Currently element does not support unicode separators. All separators must be 1 byte characters. This limitation is highlighted as a bug, albeit a low priority one. If this limitation does directly affect you then raise an issue on GitHub to get the priority bumped up.
  2. Any shell tokens (eg pipe |, ;, }, etc) will need to be escaped. For readability reasons it is recommended not to use such characters even though it is technically possible to.

     # Would fail because the semi-colon is an unescaped / unquoted shell token
     config -> [[ ;shell-syntax-highlighting;Data-Type ]]
  3. Please also make sure you don’t use a character that is also used inside key names because keys cannot be escaped. For example both of the following would fail:

     # Would fail because 'syntax-highlighting' and 'Data-Type' both also contain
     # the separator character
     config -> [[ -shell-syntax-highlighting-Data-Type ]]
    
     # Would fail because you cannot escape key names (escaping happens at the
     # shell parser level rather than command parameter level)
     config -> [[ -shell-syntax\-highlighting-Data\-Type ]]

Quoting parameters

In murex, everything is a function. Thus even [[ is a function name and the closing ]] is actually a last parameter. This means the recommended way to quote element parameters is to quote specific key names or the entire path:

» config -> [[ /shell/"syntax-highlighting"/Data-Type ]]
bool

» config -> [[ "|shell|syntax-highlighting|Data-Type" ]]
bool

Synonyms

See Also

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Thu Oct 13 08:08:18 UTC 2022 against commit ed6b6fced6b6fc609f4be93c5d3348695a762facfecf48f.

Current version is 2.11.2200 which has been verified against 16798 tests cases.