LINES (int)

Character height of terminal

Description

LINES returns the cell height of the terminal.

This is a reserved variable so it cannot be changed.

Detail

The Murex controlling terminal is assumed to be the terminal. If Stdout cannot be successfully queried for its dimensions, for example Murex is a piped rather than controlling a TTY, then $LINES will generate an error:

» exec $MUREX_EXE -c 'out $LINES' -> cat
Error in `out` ( 1,1):
      Command: out $LINES
      Error: cannot assign value to $LINES: inappropriate ioctl for device
          > Expression: out $LINES
          >           :          ^
          > Character : 9
Error in `/Users/laurencemorgan/dev/go/src/github.com/lmorg/murex/murex` (0,1): exit status 1

This error can be caught via ||, try et al.

See Also

• Execute External Command (exec): Runs an executable
• Interactive Shell: What's different about Murex's interactive shell?
• Reserved Variables: Special variables reserved by Murex
• Try Block (try): Handles non-zero exits inside a block of code
• COLUMNS (int): Character width of terminal
• MUREX_EXE (path): Absolute path to running shell
• int: Whole number (primitive)
• || Or Logical Operator: Continues next operation only if previous operation fails

---

This document was generated from gen/variables/LINES_doc.yaml.