Atari ST series - Page 185

Bconin
Read a Character
Bconin()
Opcode = 2
B c o n in () w a its for a sin g le ch a ra cter to b ec om e av ailab le from o n e o f th e
in pu t d ev ices, a n d th en re ad s th a t ch ara cte r. If a c h a ra cte r is available a t
th e tim e th e call is m a d e , th is fu n ctio n re ad s it an d re tu rn s im m e d iately.
O th erw ise , it w aits un til a c h a rac te r is re ce iv ed .
C macro format
in t d ev n u m ;
lo ng ch ar;
ch a r = B con in (d e vn u m );
Machine language format
m o v e.w # d e v n u m , - (sp )
m o v e.w # 2 , - ( s p )
tra p # 1 3
ad d q .l # 4 ,s p
Inputs
d ev n u m
Results
DO ch ar
w o rd T h e d ev ice n u m b er of th e in pu t d ev ice
fro m w h ic h to receive th e ch ara cte r:
1 = A U X : (R S-232 p ort)
2 = C O N : (C on so le k ey bo ard )
3 = M ID I: (M ID I in p ut)
lo n g T h e A S C II ch a ra cte r rece iv ed fro m th e d ev ice is re 
tu rn ed in th e le ast sig n ifican t by te o f th e lo ng . F o r th e
co n so le d e v ice , th e le as t sign ifican t by te of th e high
w o rd co n ta in s a k ey co d e th a t sp e cifies th e p hy sical
k ey th a t w a s p re sse d . S ee A p p en d ix J for a co m p le te
list of s can co d es .
See also
K b s h ift(), B c o n s ta t(), B c o n o u t(), B c o s ta t()
177