Atari ST series Technical Reference Manual page 257

Hide thumbs Also See for ST series:
Table of Contents

Advertisement

Read String from Keyboard
Cconrs()
T h is f u n c t i o n r e a d s a n e n t i r e s t r i n g o f c h a r a c t e r s f r o m t h e c o n s o l e k e y ­
b o a r d , e c h o i n g e a c h c h a r a c t e r t o t h e s c r e e n a s it is r e a d . I t p r o v i d e s s o m e
li n e - e d i t i n g f u n c t i o n s a s w e l l. T h e f u n c t i o n w ill n o t r e t u r n u n til t h e u s e r
s ig n a ls t h a t t h e e n t i r e s t r i n g h a s b e e n e n t e r e d , b y p r e s s i n g t h e R e t u r n k e y ,
o r b y e n t e r i n g a s t r i n g o f t h e m a x i m u m l e n g t h . N o t e t h a t t h e e n t i r e p r o ­
g r a m ( n o t j u s t th i s f u n c t i o n ) t e r m i n a t e s if C o n t r o l - C is s t r u c k d u r i n g c h a r ­
a c t e r e n t r y .
C macro format
c h a r b u f f e r [ M A X L E N ] ;
i n t le n g t h ;
l e n g t h =
C c o n r s ( b u f f e r ) ;
Machine language format
m o v e .l
b u f f e r , - (s p )
m o v e . w
# $ 0 A , - (s p )
t r a p
# 1
a d d q .l
# 6 , s p
Inputs
b u f f e r
l o n g
Results
DO
l e n g t h
w o r d
Cconrs
T h e a d d r e s s o f a b u f f e r in t o w h i c h th e
c h a r a c t e r s w ill b e r e a d . T h e f ir s t t w o
b y t e s o f th is b u f f e r a r e r e s e r v e d . Y o u
s h o u l d p l a c e t h e m a x i m u m n u m b e r o f
c h a r a c t e r s t h a t c a n b e r e a d (b u f f e r l e n g t h
-
2 ) in t h e f ir s t b y t e . T h e f u n c t i o n w ill
t e r m i n a t e a s s o o n a s t h a t m a n y c h a r a c t e r s
h a v e b e e n r e a d . T h e l e n g t h o f th e s t r i n g
t h a t is r e a d w ill b e r e t u r n e d in t h e s e c o n d
b y t e o f t h e b u f f e r .
T h e l e n g t h o f t h e s t r i n g r e a d b y t h e f u n c t i o n .
Opcode = 10 ($0A)
249

Hide quick links:

Advertisement

Table of Contents
loading

Table of Contents