Skip to main content

read​

read(
    @path ? ## symbol (required)
    @ignore 0
) -> anything

Read .txt or native .llll data. The ignore attribute allows preventing some categories of symbols, such as parens, pitches and more, to be read according to the usual bell syntax.

Arguments​

  • @path ? [symbol]: input file path. (required)
  • @ignore [symbol/null]: The ignore attribute can be set to any combination of the following characters (default: 0).
    • 'l': parens inside symbols are not llll levels, but symbols composed by parens only are kept as llll levels!
    • 'L': all parens are not parsed as llll levels
    • 'p': ignore pitches, keep them as symbols
    • 'r': ignore rationals, keep them as symbols
    • 'e': ignore floating-point scientific notation, keep it as symbol
    • 's': keep the special symbols nil and null as symbols
    • 'b': symbols with a backtick are interpreted literally, with the backtick included
    • 0: don't ignore anything
    • 1: ignore everything
    • '-': invert selection

Output​

file content [anything]