Readline¶

Line editing, history, and tab completion.

class ref Readline is
  ANSINotify ref

Implements¶

ANSINotify ref

Constructors¶

create¶

[Source]

Create a readline handler to be passed to stdin. It begins blocked. Set an initial prompt on the ANSITerm to begin processing.

new iso create(
  notify: ReadlineNotify iso,
  out: OutStream tag,
  path: (FilePath val | None val) = reference,
  maxlen: USize val = 0)
: Readline iso^

Parameters¶

notify: ReadlineNotify iso
out: OutStream tag
path: (FilePath val | None val) = reference
maxlen: USize val = 0

Returns¶

Readline iso^

Public Functions¶

apply¶

[Source]

Receives input.

fun ref apply(
  term: ANSITerm ref,
  input: U8 val)
: None val

Parameters¶

term: ANSITerm ref
input: U8 val

Returns¶

None val

prompt¶

[Source]

Set a new prompt, unblock, and handle the pending queue.

fun ref prompt(
  term: ANSITerm ref,
  value: String val)
: None val

Parameters¶

term: ANSITerm ref
value: String val

Returns¶

None val

closed¶

[Source]

No more input is available.

fun ref closed()
: None val

Returns¶

None val

up¶

[Source]

Previous line.

fun ref up(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

down¶

[Source]

Next line.

fun ref down(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

left¶

[Source]

Move left.

fun ref left(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

right¶

[Source]

Move right.

fun ref right(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

home¶

[Source]

Beginning of the line.

fun ref home(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

end_key¶

[Source]

End of the line.

fun ref end_key(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

delete¶

[Source]

Forward delete.

fun ref delete(
  ctrl: Bool val = false,
  alt: Bool val = false,
  shift: Bool val = false)
: None val

Parameters¶

ctrl: Bool val = false
alt: Bool val = false
shift: Bool val = false

Returns¶

None val

insert¶

fun ref insert(
  ctrl: Bool val,
  alt: Bool val,
  shift: Bool val)
: None val

Parameters¶

ctrl: Bool val
alt: Bool val
shift: Bool val

Returns¶

None val

page_up¶

fun ref page_up(
  ctrl: Bool val,
  alt: Bool val,
  shift: Bool val)
: None val

Parameters¶

ctrl: Bool val
alt: Bool val
shift: Bool val

Returns¶

None val

page_down¶

fun ref page_down(
  ctrl: Bool val,
  alt: Bool val,
  shift: Bool val)
: None val

Parameters¶

ctrl: Bool val
alt: Bool val
shift: Bool val

Returns¶

None val

fn_key¶

fun ref fn_key(
  i: U8 val,
  ctrl: Bool val,
  alt: Bool val,
  shift: Bool val)
: None val

Parameters¶

i: U8 val
ctrl: Bool val
alt: Bool val
shift: Bool val

Returns¶

None val

size¶

fun ref size(
  rows: U16 val,
  cols: U16 val)
: None val

Parameters¶

rows: U16 val
cols: U16 val

Returns¶

None val

Private Functions¶

_backspace¶

[Source]

Backward delete.

fun ref _backspace()
: None val

Returns¶

None val

_clear¶

[Source]

Clear the screen.

fun ref _clear()
: None val

Returns¶

None val

_swap¶

[Source]

Swap the previous character with the current one.

fun ref _swap()
: None val

Returns¶

None val

_delete_prev_word¶

[Source]

Delete the previous word.

fun ref _delete_prev_word()
: None val

Returns¶

None val

_tab¶

[Source]

Tab completion.

TODO: Improve this.

fun ref _tab()
: None val

Returns¶

None val

_dispatch¶

[Source]

Send a finished line to the notifier.

fun ref _dispatch(
  term: ANSITerm tag)
: None val

Parameters¶

term: ANSITerm tag

Returns¶

None val

_handle_line¶

[Source]

Dispatch a single line.

fun ref _handle_line(
  term: ANSITerm tag,
  line: String val)
: None val

Parameters¶

term: ANSITerm tag
line: String val

Returns¶

None val

_refresh_line¶

[Source]

Refresh the line on screen.

fun ref _refresh_line()
: None val

Returns¶

None val

_add_history¶

[Source]

Add a line to the history, trimming an earlier line if necessary.

fun ref _add_history(
  line: String val)
: None val

Parameters¶

line: String val

Returns¶

None val

_load_history¶

[Source]

Load the history from a file.

fun ref _load_history()
: None val

Returns¶

None val

_save_history¶

[Source]

Write the history back to a file.

fun box _save_history()
: None val

Returns¶

None val