Showing changes from revision #5 to #6:
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) |
This SWI does not work correctly under RISC OS 5
R0 | |
R1 | |
R2 | |
R3 | |
R4 | |
C flag is set if input is terminated by an escape condition |
Exit | |
---|---|
R0 | “Corrupted” (all implementations return the buffer address, minus flags) |
R1 | Chars read, excluding Return |
R2 | “Corrupted” (all implementations preserve R2) |
R3 | “Corrupted” (all implementations preserve 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 a flag in the top bit of R1 to select theOS_ReadLine32 API instead. This identified identifies theAPI in use on ReadLineV. ReadLineV in 26bit processor modes.