AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
=>     R0 =     buffer
     R1 =     size of buffer
     R2 =     lowest char allowed
     R3 =     highest char allowed
     R4 =     flags and character to output in bottom byte (if bit 30 set)

<=     R0 corrupted
     R1 =     chars read, excluding Return
     R2 corrupted
     R3 corrupted
     R4 preserved
     C set if Escape

This SWI reads a line from the current input stream. Input is terminated with Return, Ctrl-J or Escape. Delete and Backspace deletes last char entered. Ctrl-U empties buffer.

When the buffer is full, each successive attempt to enter a character results in a Ctrl-G 'beep'.

The CallASWI module (version 0.03) allows this SWI to be used with RISC OS pre 5.00.

See PRM 1, page 910.
OS_ReadLine flags
Bit     Meaning if set

31     Echo only characters entering buffer
30     Echo character in bottom 8 bits of R4 (password style)

[sh-index] Back to list of manuals