Atari ST series Technical Reference Manual page 185

Bconin()
B c o n i n ( ) w a i t s f o r a s i n g l e c h a r a c t e r to b e c o m e a v a i la b l e f r o m o n e o f t h e
i n p u t d e v i c e s , a n d t h e n r e a d s t h a t c h a r a c t e r . If a c h a r a c t e r is a v a i la b l e a t
t h e ti m e t h e c a ll is m a d e , th is f u n c t i o n r e a d s it a n d r e t u r n s i m m e d i a t e l y .
O t h e r w i s e , it w a i t s u n til a c h a r a c t e r is r e c e i v e d .
C macro format
i n t d e v n u m ;
lo n g c h a r ;
c h a r = B c o n i n ( d e v n u m ) ;
Machine language format
m o v e . w # d e v n u m , - (s p )
m o v e . w # 2 , - ( s p )
tr a p # 1 3
a d d q .l # 4 , s p
Inputs
d e v n u m w o r d
Results
DO c h a r lo n g
See also
K b s h i f t ( ) , B c o n s t a t ( ) , B c o n o u t ( ) , B c o s t a t ( )
Bconin
Read a Character
T h e d e v i c e n u m b e r o f t h e i n p u t d e v i c e
f r o m w h i c h t o r e c e i v e th e c h a r a c t e r :
1 =
2 =
3 =
T h e A S C I I c h a r a c t e r r e c e i v e d f r o m t h e d e v i c e is r e ­
t u r n e d in t h e l e a s t s ig n if ic a n t b y t e o f t h e l o n g . F o r th e
c o n s o l e d e v i c e , t h e l e a s t s i g n i f i c a n t b y t e o f t h e h i g h
w o r d c o n t a i n s a k e y c o d e t h a t s p e c if ie s th e p h y s i c a l
k e y t h a t w a s p r e s s e d . S e e A p p e n d i x J f o r a c o m p l e t e
l i s t o f s c a n c o d e s .
A U X : ( R S - 2 3 2 p o r t )
C O N : ( C o n s o l e k e y b o a r d )
M I D I: (M ID I i n p u t)
Opcode = 2
177