OS_ReadLine32 (changes)
Showing changes from revision #5 to #6:
Added | Removed | Changed
OS SWI Calls
» OS_ReadLine32
OS_ReadLine32
(SWI &7D)
| Entry | |
|---|---|
| R0 | Buffer |
| R1 | Size of buffer -1 (maximum number of bytes to return excluding CR) |
| R2 | Lowest char allowed |
| R3 | Highest char allowed |
| R4 | Flags and character to output in bottom byte (if bit 30 set) |
| Exit | |
|---|---|
| R0 | “Corrupted” (all implementations have preserved R0) |
| R1 | |
| R2 | “Corrupted” (all implementations have preserved R2) |
| R3 | “Corrupted” (all implementations have preserved R3) |
| R4 | Preserved |
| C flag is set if input is terminated by an escape condition | |
Use
The purpose of this call is to read a line from the current input stream.
Notes
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 also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.