github.com/lmorg/murex@v0.0.0-20240217211045-e081c89cd4ef/docs/commands/left.md (about)

     1  # `left`
     2  
     3  > Left substring every item in a list
     4  
     5  ## Description
     6  
     7  Takes a list from STDIN and returns a left substring of that same list.
     8  
     9  One parameter is required and that is the number of characters to return. If
    10  the parameter is a negative then `left` counts from the right.
    11  
    12  ## Usage
    13  
    14  ```
    15  <stdin> -> left int -> <stdout>
    16  ```
    17  
    18  ## Examples
    19  
    20  Count from the left
    21  
    22  ```
    23  » ja [Monday..Wednesday] -> left 2
    24  [
    25      "Mo",
    26      "Tu",
    27      "We"
    28  ]
    29  ```
    30  
    31  Count from the right
    32  
    33  ```
    34  » ja [Monday..Wednesday] -> left -3
    35  [
    36      "Mon",
    37      "Tues",
    38      "Wednes"
    39  ]
    40  ```
    41  
    42  ## Detail
    43  
    44  Supported data types can queried via `runtime`
    45  
    46  ```
    47  runtime --marshallers
    48  runtime --unmarshallers
    49  ```
    50  
    51  ## Synonyms
    52  
    53  * `left`
    54  * `list.left`
    55  
    56  
    57  ## See Also
    58  
    59  * [`a` (mkarray)](../commands/a.md):
    60    A sophisticated yet simple way to build an array or list
    61  * [`count`](../commands/count.md):
    62    Count items in a map, list or array
    63  * [`ja` (mkarray)](../commands/ja.md):
    64    A sophisticated yet simply way to build a JSON array
    65  * [`lang.MarshalData()` (system API)](../apis/lang.MarshalData.md):
    66    Converts structured memory into a Murex data-type (eg for stdio)
    67  * [`lang.UnmarshalData()` (system API)](../apis/lang.UnmarshalData.md):
    68    Converts a Murex data-type into structured memory
    69  * [`prefix`](../commands/prefix.md):
    70    Prefix a string to every item in a list
    71  * [`right`](../commands/right.md):
    72    Right substring every item in a list
    73  * [`runtime`](../commands/runtime.md):
    74    Returns runtime information on the internal state of Murex
    75  * [`suffix`](../commands/suffix.md):
    76    Prefix a string to every item in a list
    77  
    78  <hr/>
    79  
    80  This document was generated from [builtins/core/lists/push_pop_doc.yaml](https://github.com/lmorg/murex/blob/master/builtins/core/lists/push_pop_doc.yaml).