h6. [[OS SWI Calls]] h6(. » OS_ReadLine32 h2. OS_ReadLine32 h5. (SWI &7D) |_<^{width:4em}. 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 |<^. [[OS_ReadLine Flags|Flags]] and character to output in bottom byte (if bit 30 set) | |_<^{width:4em}. Exit | | |<^. R0 |<^. “Corrupted” (all implementations have preserved R0) | |<^. R1 |<^. Bytes read, excluding Return | |<^. R2 |<^. “Corrupted” (all implementations have preserved R2) | |<^. R3 |<^. “Corrupted” (all implementations have preserved R3) | |<^. R4 |<^. Preserved | |\2<^. C flag is set if input is terminated by an escape condition | h4. Use The purpose of this call is to read a line from the current input stream. h4. 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. h4. See also * [[OS_ReadLine]] * [[OS_ReadLine Flags]]