RISC OS Open
A fast and easily customised operating system for ARM devices
ROOL
Home | News | Software | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account

OS_Byte 129 (time)

Programmer's Reference Manuals
» Part 15 – SWI Calls
» OS
» OS_Byte
» OS_Byte 129
» OS_Byte 129 (read a key within time limit)

OS_Byte 129 (read a key within time limit)

(SWI &06)
Entry
R0 129 (&81)
R1 0-255 (time limit low byte)
R2 &00 – &7F (time limit high byte)
Exit
R0 Preserved
R1 ASCII code of character read, undefined if not read
R2 0 character read
27 escape condition
255 timeout

Use

The purpose of this call is to read a key within a specified time limit.

Notes

This call will extract a character from the keyboard buffer/current function key expansion if one is available, else will wait for (R2 * 256 + R1) centiseconds, where the maximum wait is 327.67 seconds, as R2 <= 127.

Cursor edit mode will operate if enabled with OS_Byte 4.

If an escape condition is detected the application should either acknowledge it with OS_Byte 126 or clear it with OS_Byte 124.

See also

  • OS_Byte
  • OS_Byte 129
  • OS_Byte 129 (read OS version)
  • OS_Byte 129 (scan keyboard for range of keys)
  • OS_Byte 129 (scan keyboard for single key)
Created on November 13, 2009 22:23:14 by Alan Robertson (52)? (127.0.0.1)
Edit | Views: Print | Source | Linked from: OS_Byte 129, OS_Byte 129 (OS), OS_Byte 129 (scan range), OS_Byte 129 (scan single)

Search the Wiki

Commercial use

For commercial enquiries, please contact the owners of RISC OS, Castle Technology Ltd.

ROOL Store

The official C/C++ Development kit and more here.

Donate! Why?

Help ROOL make things happen – please consider donating!

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
Site design © RISC OS Open Limited 2011 except where indicated
The RISC OS Open Instiki theme is based on Insitki's default layout

Valid XHTML 1.0  |  Valid CSS

Instiki 0.19.1(MML+)
This site runs on Rails

Hosted by Arachsys