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

     1  # `str` (string)
     2  
     3  > string (primitive)
     4  
     5  ## Description
     6  
     7  This type is modelled closely on generic but is more tailored for textual
     8  (non-tabulated) data.
     9  
    10  ## Supported Hooks
    11  
    12  * `Marshal()`
    13      Supported
    14  * `ReadArray()`
    15      Treats each new line as a new array element
    16  * `ReadArrayWithType()`
    17      Treats each new line as a new array element, each array element is `str` 
    18  * `ReadIndex()`
    19      Indexes treated as a new line separated list
    20  * `ReadMap()`
    21      Treats each new line as a numbered map element
    22  * `ReadNotIndex()`
    23      Indexes treated as a new line separated list
    24  * `Unmarshal()`
    25      Supported
    26  * `WriteArray()`
    27      Writes a new line per array element
    28  
    29  ## See Also
    30  
    31  * [`*` (generic)](../types/generic.md):
    32    generic (primitive)
    33  * [`[[ Element ]]`](../parser/element.md):
    34    Outputs an element from a nested structure
    35  * [`cast`](../commands/cast.md):
    36    Alters the data type of the previous function without altering it's output
    37  * [`format`](../commands/format.md):
    38    Reformat one data-type into another data-type
    39  * [`int`](../types/int.md):
    40    Whole number (primitive)
    41  * [`num` (number)](../types/num.md):
    42    Floating point number (primitive)
    43  * [`open`](../commands/open.md):
    44    Open a file with a preferred handler
    45  * [`runtime`](../commands/runtime.md):
    46    Returns runtime information on the internal state of Murex
    47  * [index](../parser/item-index.md):
    48    Outputs an element from an array, map or table
    49  
    50  ### Read more about type hooks
    51  
    52  - [`ReadIndex()` (type)](../apis/ReadIndex.md): Data type handler for the index, `[`, builtin
    53  - [`ReadNotIndex()` (type)](../apis/ReadNotIndex.md): Data type handler for the bang-prefixed index, `![`, builtin
    54  - [`ReadArray()` (type)](../apis/ReadArray.md): Read from a data type one array element at a time
    55  - [`WriteArray()` (type)](../apis/WriteArray.md): Write a data type, one array element at a time
    56  - [`ReadMap()` (type)](../apis/ReadMap.md): Treat data type as a key/value structure and read its contents
    57  - [`Marshal()` (type)](../apis/Marshal.md): Converts structured memory into a structured file format (eg for stdio)
    58  - [`Unmarshal()` (type)](../apis/Unmarshal.md): Converts a structured file format into structured memory
    59  
    60  <hr/>
    61  
    62  This document was generated from [builtins/types/string/string_doc.yaml](https://github.com/lmorg/murex/blob/master/builtins/types/string/string_doc.yaml).