Showing changes from revision #4 to #5:
Added | Removed | Changed
Entry | |
---|---|
R0 | Buffer + flags |
R1 | Size of buffer |
R2 | Lowest char allowed |
R3 | Highest char allowed |
R4 | Character to output (if bit 30 set) |
Exit | |
---|---|
R0 | |
R1 | Chars read, excluding Return |
R2 | |
R3 | |
R4 | Preserved |
C flag is set if input is terminated by an escape condition |
The purpose of this call is to read 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’.
Other than RISC OS 5, ReadLineV uses this API. RISC OS 5’s ReadLineV uses the OS_ReadLine32 API instead.
RISC OS Six introduced an flag in the top bit of R1 to select the OS_ReadLine32 API instead. This identified the API in use on ReadLineV.