Home » CEEFAX disks » telesoftware8.adl » 05-08-88/T\SWR05 » Compare

Compare 05-08-88/T\SWR05 with 05-08-88/T\SWR_OLD

File: CEEFAX disks » telesoftware8.adl » 05-08-88/T\SWR05
Compared with: CEEFAX disks » telesoftware8.adl » 05-08-88/T\SWR_OLD
Similarity: 95% of bytes duplicated

95.4% of the bytes in these files are duplicated between them. Duplicated Different Padding (ignored)

Bytes are marked as duplicated if they lie within a run of at least 16 bytes which also appears somewhere in the other file, in any position. Long runs of padding bytes (zeros, spaces, &FF and &E5) are ignored.

05-08-88/T\SWR05
00000000  4d 61 73 74 65 72 69 6e  67 20 53 69 64 65 77 61  |Mastering Sidewa|
00000010  79 73 20 52 4f 4d 20 26  20 52 41 4d 20 2d 20 4d  |ys ROM & RAM - M|
00000020  6f 64 75 6c 65 20 30 35  20 2d 20 52 65 61 64 69  |odule 05 - Readi|
00000030  6e 67 20 61 72 67 75 6d  65 6e 74 73 0d 2d 2d 2d  |ng arguments.---|
00000040  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000070  2d 2d 2d 2d 2d 2d 2d 2d  2d 0d 0d 20 20 49 6e 20  |---------..  In |
00000080  74 68 69 73 20 6d 6f 64  75 6c 65 20 49 20 77 69  |this module I wi|
00000090  6c 6c 20 65 78 74 65 6e  64 20 74 68 65 20 69 6e  |ll extend the in|
000000a0  74 65 72 70 72 65 74 65  72 20 69 6e 74 72 6f 64  |terpreter introd|
000000b0  75 63 65 64 20 69 6e 20  4d 6f 64 75 6c 65 20 33  |uced in Module 3|
000000c0  0d 74 6f 20 69 6e 63 6c  75 64 65 20 72 65 61 64  |.to include read|
000000d0  69 6e 67 20 61 72 67 75  6d 65 6e 74 73 20 77 68  |ing arguments wh|
000000e0  69 63 68 20 66 6f 6c 6c  6f 77 20 74 68 65 20 2a  |ich follow the *|
000000f0  20 63 6f 6d 6d 61 6e 64  2e 0d 0d 20 20 54 68 65  | command...  The|
00000100  72 65 20 61 72 65 20 74  77 6f 20 4d 4f 53 20 73  |re are two MOS s|
00000110  75 62 72 6f 75 74 69 6e  65 73 20 75 73 65 64 20  |ubroutines used |
00000120  74 6f 20 72 65 61 64 20  61 72 67 75 6d 65 6e 74  |to read argument|
00000130  73 2e 20 54 68 65 79 20  61 72 65 0d 47 73 69 6e  |s. They are.Gsin|
00000140  69 74 20 61 74 20 26 46  46 43 32 20 61 6e 64 20  |it at &FFC2 and |
00000150  47 73 72 65 61 64 20 61  74 20 26 46 46 43 35 2e  |Gsread at &FFC5.|
00000160  0d 0d 20 20 47 73 69 6e  69 74 20 73 68 6f 75 6c  |..  Gsinit shoul|
00000170  64 20 62 65 20 75 73 65  64 20 74 6f 20 69 6e 69  |d be used to ini|
00000180  74 69 61 6c 69 73 65 20  61 6e 20 61 72 67 75 6d  |tialise an argum|
00000190  65 6e 74 20 77 68 69 63  68 20 69 73 20 74 6f 20  |ent which is to |
000001a0  62 65 20 72 65 61 64 0d  75 73 69 6e 67 20 47 73  |be read.using Gs|
000001b0  72 65 61 64 2e 20 47 73  69 6e 69 74 20 75 73 65  |read. Gsinit use|
000001c0  73 20 74 68 65 20 74 65  78 74 20 70 6f 69 6e 74  |s the text point|
000001d0  65 72 73 20 61 74 20 26  46 32 20 61 6e 64 20 26  |ers at &F2 and &|
000001e0  46 33 20 77 69 74 68 20  61 6e 0d 6f 66 66 73 65  |F3 with an.offse|
000001f0  74 20 69 6e 20 74 68 65  20 59 20 72 65 67 69 73  |t in the Y regis|
00000200  74 65 72 20 74 6f 20 69  64 65 6e 74 69 66 79 20  |ter to identify |
00000210  74 68 65 20 61 72 67 75  6d 65 6e 74 20 61 64 64  |the argument add|
00000220  72 65 73 73 2e 20 54 68  65 0d 61 72 67 75 6d 65  |ress. The.argume|
00000230  6e 74 20 63 61 6e 20 62  65 20 65 6e 63 6c 6f 73  |nt can be enclos|
00000240  65 64 20 62 79 20 71 75  6f 74 61 74 69 6f 6e 20  |ed by quotation |
00000250  6d 61 72 6b 73 20 62 75  74 20 69 74 20 64 6f 65  |marks but it doe|
00000260  73 20 6e 6f 74 20 68 61  76 65 20 74 6f 0d 62 65  |s not have to.be|
00000270  2e 20 47 73 69 6e 69 74  20 69 73 20 75 73 65 64  |. Gsinit is used|
00000280  20 74 6f 20 73 74 72 69  70 20 6f 66 66 20 61 6e  | to strip off an|
00000290  79 20 6c 65 61 64 69 6e  67 20 73 70 61 63 65 73  |y leading spaces|
000002a0  20 61 6e 64 20 74 6f 20  73 65 74 20 75 70 20 61  | and to set up a|
000002b0  6e 0d 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 62 79  |n.information by|
000002c0  74 65 20 69 6e 20 7a 65  72 6f 20 70 61 67 65 20  |te in zero page |
000002d0  77 68 69 63 68 20 69 6e  64 69 63 61 74 65 73 20  |which indicates |
000002e0  74 68 65 20 74 65 72 6d  69 6e 61 74 69 6f 6e 0d  |the termination.|
000002f0  63 68 61 72 61 63 74 65  72 20 6f 66 20 74 68 65  |character of the|
00000300  20 61 72 67 75 6d 65 6e  74 2e 0d 0d 20 20 42 65  | argument...  Be|
00000310  66 6f 72 65 20 63 61 6c  6c 69 6e 67 20 47 73 69  |fore calling Gsi|
00000320  6e 69 74 20 79 6f 75 20  73 68 6f 75 6c 64 20 63  |nit you should c|
00000330  6c 65 61 72 20 74 68 65  20 63 61 72 72 79 20 66  |lear the carry f|
00000340  6c 61 67 20 69 66 20 79  6f 75 20 77 61 6e 74 0d  |lag if you want.|
00000350  74 68 65 20 73 65 63 6f  6e 64 20 71 75 6f 74 61  |the second quota|
00000360  74 69 6f 6e 20 6d 61 72  6b 2c 20 74 68 65 20 66  |tion mark, the f|
00000370  69 72 73 74 20 73 70 61  63 65 20 77 69 74 68 69  |irst space withi|
00000380  6e 20 74 68 65 20 61 72  67 75 6d 65 6e 74 2c 20  |n the argument, |
00000390  6f 72 20 61 0d 63 61 72  72 69 61 67 65 20 72 65  |or a.carriage re|
000003a0  74 75 72 6e 20 61 73 20  74 68 65 20 74 65 72 6d  |turn as the term|
000003b0  69 6e 61 74 69 6e 67 20  63 68 61 72 61 63 74 65  |inating characte|
000003c0  72 2e 20 59 6f 75 20 73  68 6f 75 6c 64 20 73 65  |r. You should se|
000003d0  74 20 74 68 65 20 63 61  72 72 79 0d 66 6c 61 67  |t the carry.flag|
000003e0  20 62 65 66 6f 72 65 20  63 61 6c 6c 69 6e 67 20  | before calling |
000003f0  47 73 69 6e 69 74 20 69  66 20 79 6f 75 20 64 6f  |Gsinit if you do|
00000400  20 6e 6f 74 20 77 61 6e  74 20 61 20 73 70 61 63  | not want a spac|
00000410  65 20 74 6f 20 62 65 20  72 65 63 6f 67 6e 69 73  |e to be recognis|
00000420  65 64 0d 61 73 20 61 20  74 65 72 6d 69 6e 61 74  |ed.as a terminat|
00000430  69 6e 67 20 63 68 61 72  61 63 74 65 72 2e 20 49  |ing character. I|
00000440  66 20 69 6e 20 64 6f 75  62 74 2c 20 73 65 74 20  |f in doubt, set |
00000450  74 68 65 20 63 61 72 72  79 20 66 6c 61 67 20 62  |the carry flag b|
00000460  65 66 6f 72 65 0d 63 61  6c 6c 69 6e 67 20 47 73  |efore.calling Gs|
00000470  69 6e 69 74 2e 0d 0d 20  20 41 66 74 65 72 20 63  |init...  After c|
00000480  61 6c 6c 69 6e 67 20 47  73 69 6e 69 74 20 74 68  |alling Gsinit th|
00000490  65 20 59 20 72 65 67 69  73 74 65 72 20 63 6f 6e  |e Y register con|
000004a0  74 61 69 6e 73 20 61 6e  20 6f 66 66 73 65 74 20  |tains an offset |
000004b0  74 6f 20 74 68 65 20 66  69 72 73 74 0d 63 68 61  |to the first.cha|
000004c0  72 61 63 74 65 72 20 6f  66 20 74 68 65 20 61 72  |racter of the ar|
000004d0  67 75 6d 65 6e 74 20 61  6e 64 20 74 68 65 20 61  |gument and the a|
000004e0  63 63 75 6d 75 6c 61 74  6f 72 20 63 6f 6e 74 61  |ccumulator conta|
000004f0  69 6e 73 20 74 68 65 20  66 69 72 73 74 0d 63 68  |ins the first.ch|
00000500  61 72 61 63 74 65 72 20  6f 66 20 74 68 65 20 61  |aracter of the a|
00000510  72 67 75 6d 65 6e 74 2e  20 54 68 65 20 7a 65 72  |rgument. The zer|
00000520  6f 20 66 6c 61 67 20 69  73 20 73 65 74 20 69 66  |o flag is set if|
00000530  20 74 68 65 20 61 72 67  75 6d 65 6e 74 20 69 73  | the argument is|
00000540  20 61 0d 6e 75 6c 6c 20  73 74 72 69 6e 67 2e 0d  | a.null string..|
00000550  0d 20 20 46 6f 72 20 65  78 61 6d 70 6c 65 2c 20  |.  For example, |
00000560  69 6d 61 67 69 6e 65 20  79 6f 75 20 68 61 76 65  |imagine you have|
00000570  20 74 79 70 65 64 20 2a  43 55 52 53 4f 52 20 4f  | typed *CURSOR O|
00000580  4e 20 61 6e 64 20 74 68  65 20 69 6e 74 65 72 70  |N and the interp|
00000590  72 65 74 65 72 0d 68 61  73 20 72 65 63 6f 67 6e  |reter.has recogn|
000005a0  69 73 65 64 20 74 68 65  20 63 6f 6d 6d 61 6e 64  |ised the command|
000005b0  20 43 55 52 53 4f 52 2e  20 42 65 66 6f 72 65 20  | CURSOR. Before |
000005c0  63 61 6c 6c 69 6e 67 20  47 73 69 6e 69 74 2c 20  |calling Gsinit, |
000005d0  74 68 65 20 74 65 78 74  0d 70 6f 69 6e 74 65 72  |the text.pointer|
000005e0  73 20 61 74 20 26 46 32  20 61 6e 64 20 26 46 33  |s at &F2 and &F3|
000005f0  20 77 69 6c 6c 20 70 6f  69 6e 74 20 74 6f 20 74  | will point to t|
00000600  68 65 20 63 6f 6d 6d 61  6e 64 20 77 69 74 68 20  |he command with |
00000610  74 68 65 20 6f 66 66 73  65 74 20 69 6e 20 59 0d  |the offset in Y.|
00000620  70 6f 69 6e 74 69 6e 67  20 74 6f 20 74 68 65 20  |pointing to the |
00000630  73 65 63 6f 6e 64 20 52  20 6f 66 20 43 55 52 53  |second R of CURS|
00000640  4f 52 2e 20 41 66 74 65  72 20 63 61 6c 6c 69 6e  |OR. After callin|
00000650  67 20 47 73 69 6e 69 74  20 74 68 65 20 6f 66 66  |g Gsinit the off|
00000660  73 65 74 20 69 6e 0d 59  20 77 69 6c 6c 20 70 6f  |set in.Y will po|
00000670  69 6e 74 20 74 6f 20 74  68 65 20 4f 20 6f 66 20  |int to the O of |
00000680  4f 4e 2c 20 74 68 65 20  7a 65 72 6f 20 66 6c 61  |ON, the zero fla|
00000690  67 20 77 69 6c 6c 20 62  65 20 63 6c 65 61 72 2c  |g will be clear,|
000006a0  20 61 6e 64 20 74 68 65  0d 74 65 72 6d 69 6e 61  | and the.termina|
000006b0  74 69 6e 67 20 63 68 61  72 61 63 74 65 72 20 77  |ting character w|
000006c0  69 6c 6c 20 62 65 20 74  68 65 20 63 61 72 72 69  |ill be the carri|
000006d0  61 67 65 20 72 65 74 75  72 6e 20 61 66 74 65 72  |age return after|
000006e0  20 74 68 65 20 4e 20 6f  66 20 4f 4e 2e 0d 49 66  | the N of ON..If|
000006f0  20 4f 4e 20 69 73 20 65  6e 63 6c 6f 73 65 64 20  | ON is enclosed |
00000700  62 79 20 71 75 6f 74 61  74 69 6f 6e 20 6d 61 72  |by quotation mar|
00000710  6b 73 20 74 68 65 20 6f  66 66 73 65 74 20 69 6e  |ks the offset in|
00000720  20 59 20 77 69 6c 6c 20  73 74 69 6c 6c 20 70 6f  | Y will still po|
00000730  69 6e 74 0d 74 6f 20 74  68 65 20 4f 20 6f 66 20  |int.to the O of |
00000740  4f 4e 20 61 6e 64 20 74  68 65 20 7a 65 72 6f 20  |ON and the zero |
00000750  66 6c 61 67 20 77 69 6c  6c 20 62 65 20 63 6c 65  |flag will be cle|
00000760  61 72 2c 20 62 75 74 20  74 68 65 20 74 65 72 6d  |ar, but the term|
00000770  69 6e 61 74 69 6e 67 0d  63 68 61 72 61 63 74 65  |inating.characte|
00000780  72 20 77 69 6c 6c 20 62  65 20 74 68 65 20 73 65  |r will be the se|
00000790  63 6f 6e 64 20 71 75 6f  74 61 74 69 6f 6e 20 6d  |cond quotation m|
000007a0  61 72 6b 2e 20 49 66 20  61 6e 20 61 72 67 75 6d  |ark. If an argum|
000007b0  65 6e 74 20 69 73 20 6e  6f 74 0d 74 79 70 65 64  |ent is not.typed|
000007c0  20 6f 72 20 69 66 20 2a  43 55 52 53 4f 52 20 22  | or if *CURSOR "|
000007d0  22 20 69 73 20 74 79 70  65 64 20 74 68 65 20 7a  |" is typed the z|
000007e0  65 72 6f 20 66 6c 61 67  20 77 69 6c 6c 20 62 65  |ero flag will be|
000007f0  20 73 65 74 20 6f 6e 20  72 65 74 75 72 6e 0d 66  | set on return.f|
00000800  72 6f 6d 20 47 73 69 6e  69 74 2e 20 46 69 67 75  |rom Gsinit. Figu|
00000810  72 65 20 35 2e 31 20 73  68 6f 77 73 20 74 68 65  |re 5.1 shows the|
00000820  20 6f 66 66 73 65 74 20  69 6e 20 74 68 65 20 59  | offset in the Y|
00000830  20 72 65 67 69 73 74 65  72 20 70 6f 69 6e 74 69  | register pointi|
00000840  6e 67 20 74 6f 0d 74 68  65 20 65 6e 64 20 6f 66  |ng to.the end of|
00000850  20 74 68 65 20 63 6f 6d  6d 61 6e 64 20 62 65 66  | the command bef|
00000860  6f 72 65 20 63 61 6c 6c  69 6e 67 20 47 73 69 6e  |ore calling Gsin|
00000870  69 74 20 61 6e 64 20 70  6f 69 6e 74 69 6e 67 20  |it and pointing |
00000880  74 6f 20 74 68 65 0d 62  65 67 69 6e 6e 69 6e 67  |to the.beginning|
00000890  20 6f 66 20 74 68 65 20  61 72 67 75 6d 65 6e 74  | of the argument|
000008a0  20 61 66 74 65 72 20 63  61 6c 6c 69 6e 67 20 47  | after calling G|
000008b0  73 69 6e 69 74 2e 0d 0d  0d 0d 0d 20 20 20 20 20  |sinit......     |
000008c0  20 20 2b 2d 20 59 20 62  65 66 6f 72 65 20 47 73  |  +- Y before Gs|
000008d0  69 6e 69 74 20 2d 2b 0d  20 20 20 20 20 20 20 21  |init -+.       !|
000008e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000008f0  20 20 20 21 0d 20 20 20  20 20 20 20 76 20 20 20  |   !.       v   |
00000900  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000910  76 0d 3e 2a 43 55 52 53  4f 52 20 4f 4e 20 20 20  |v.>*CURSOR ON   |
00000920  20 20 20 20 20 20 3e 2a  43 55 52 53 4f 52 20 22  |      >*CURSOR "|
00000930  4f 4e 22 0d 20 20 20 20  20 20 20 20 20 5e 20 20  |ON".         ^  |
00000940  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000950  20 20 5e 0d 20 20 20 20  20 20 20 20 20 21 20 20  |  ^.         !  |
00000960  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000970  20 20 21 0d 20 20 20 20  20 20 20 20 20 2b 2d 2d  |  !.         +--|
00000980  20 59 20 61 66 74 65 72  20 47 73 69 6e 69 74 20  | Y after Gsinit |
00000990  2d 2d 2b 0d 0d 46 69 67  75 72 65 20 35 2e 31 20  |--+..Figure 5.1 |
000009a0  54 68 65 20 6f 66 66 73  65 74 20 69 6e 20 59 20  |The offset in Y |
000009b0  62 65 66 6f 72 65 20 61  6e 64 20 61 66 74 65 72  |before and after|
000009c0  20 63 61 6c 6c 69 6e 67  20 47 73 69 6e 69 74 2e  | calling Gsinit.|
000009d0  0d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000009e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000a00  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0d 0d 0d 0d  |------------....|
00000a10  0d 20 20 47 73 72 65 61  64 20 69 73 20 75 73 65  |.  Gsread is use|
00000a20  64 20 74 6f 20 72 65 61  64 20 65 61 63 68 20 62  |d to read each b|
00000a30  79 74 65 20 6f 66 20 74  68 65 20 61 72 67 75 6d  |yte of the argum|
00000a40  65 6e 74 2e 20 54 68 69  73 20 72 6f 75 74 69 6e  |ent. This routin|
00000a50  65 0d 73 68 6f 75 6c 64  20 6f 6e 6c 79 20 62 65  |e.should only be|
00000a60  20 75 73 65 64 20 66 6f  6c 6c 6f 77 69 6e 67 20  | used following |
00000a70  61 20 47 73 69 6e 69 74  20 63 61 6c 6c 20 6f 72  |a Gsinit call or|
00000a80  20 61 20 70 72 65 76 69  6f 75 73 20 47 73 72 65  | a previous Gsre|
00000a90  61 64 2e 0d 46 6f 6c 6c  6f 77 69 6e 67 20 47 73  |ad..Following Gs|
00000aa0  69 6e 69 74 20 74 68 65  20 74 65 78 74 20 70 6f  |init the text po|
00000ab0  69 6e 74 65 72 73 20 61  6e 64 20 59 20 72 65 67  |inters and Y reg|
00000ac0  69 73 74 65 72 20 77 69  6c 6c 20 70 6f 69 6e 74  |ister will point|
00000ad0  20 74 6f 20 74 68 65 0d  66 69 72 73 74 20 62 79  | to the.first by|
00000ae0  74 65 20 6f 66 20 74 68  65 20 61 72 67 75 6d 65  |te of the argume|
00000af0  6e 74 2e 20 41 66 74 65  72 20 63 61 6c 6c 69 6e  |nt. After callin|
00000b00  67 20 47 73 72 65 61 64  20 74 68 65 20 61 63 63  |g Gsread the acc|
00000b10  75 6d 75 6c 61 74 6f 72  0d 63 6f 6e 74 61 69 6e  |umulator.contain|
00000b20  73 20 74 68 65 20 63 68  61 72 61 63 74 65 72 20  |s the character |
00000b30  72 65 61 64 20 66 72 6f  6d 20 74 68 65 20 61 72  |read from the ar|
00000b40  67 75 6d 65 6e 74 2c 20  59 20 69 73 20 69 6e 63  |gument, Y is inc|
00000b50  72 65 6d 65 6e 74 65 64  20 74 6f 0d 70 6f 69 6e  |remented to.poin|
00000b60  74 20 74 6f 20 74 68 65  20 6e 65 78 74 20 63 68  |t to the next ch|
00000b70  61 72 61 63 74 65 72 2c  20 58 20 69 73 20 70 72  |aracter, X is pr|
00000b80  65 73 65 72 76 65 64 20  61 6e 64 20 74 68 65 20  |eserved and the |
00000b90  63 61 72 72 79 20 66 6c  61 67 20 69 73 20 73 65  |carry flag is se|
00000ba0  74 0d 69 66 20 74 68 65  20 74 65 72 6d 69 6e 61  |t.if the termina|
00000bb0  74 69 6e 67 20 63 68 61  72 61 63 74 65 72 20 68  |ting character h|
00000bc0  61 73 20 62 65 65 6e 20  72 65 61 64 2e 0d 0d 20  |as been read... |
00000bd0  20 54 68 65 20 65 66 66  65 63 74 20 6f 66 20 63  | The effect of c|
00000be0  61 6c 6c 69 6e 67 20 47  73 72 65 61 64 20 69 73  |alling Gsread is|
00000bf0  20 73 69 6d 69 6c 61 72  20 74 6f 2c 20 62 75 74  | similar to, but|
00000c00  20 6e 6f 74 20 74 68 65  20 73 61 6d 65 20 61 73  | not the same as|
00000c10  3a 0d 0d 20 20 4c 44 41  20 28 26 46 32 29 2c 59  |:..  LDA (&F2),Y|
00000c20  0d 20 20 49 4e 59 0d 0d  20 20 54 68 65 20 64 69  |.  INY..  The di|
00000c30  66 66 65 72 65 6e 63 65  20 65 78 69 73 74 73 20  |fference exists |
00000c40  62 65 63 61 75 73 65 20  47 73 72 65 61 64 20 74  |because Gsread t|
00000c50  65 73 74 73 20 74 68 65  20 63 6f 6e 74 65 6e 74  |ests the content|
00000c60  20 6f 66 20 41 20 74 6f  20 73 65 65 0d 69 66 20  | of A to see.if |
00000c70  74 68 65 20 74 65 72 6d  69 6e 61 74 69 6e 67 20  |the terminating |
00000c80  63 68 61 72 61 63 74 65  72 2c 20 61 6e 64 20 68  |character, and h|
00000c90  65 6e 63 65 20 74 68 65  20 65 6e 64 20 6f 66 20  |ence the end of |
00000ca0  74 68 65 20 61 72 67 75  6d 65 6e 74 2c 20 68 61  |the argument, ha|
00000cb0  73 0d 62 65 65 6e 20 72  65 61 64 2e 20 54 68 65  |s.been read. The|
00000cc0  20 74 65 72 6d 69 6e 61  74 69 6e 67 20 63 68 61  | terminating cha|
00000cd0  72 61 63 74 65 72 20 63  61 6e 20 62 65 20 65 69  |racter can be ei|
00000ce0  74 68 65 72 20 61 20 73  65 63 6f 6e 64 20 71 75  |ther a second qu|
00000cf0  6f 74 61 74 69 6f 6e 0d  6d 61 72 6b 2c 20 61 20  |otation.mark, a |
00000d00  73 70 61 63 65 20 6f 72  20 61 20 63 61 72 72 69  |space or a carri|
00000d10  61 67 65 20 72 65 74 75  72 6e 20 61 73 20 64 65  |age return as de|
00000d20  66 69 6e 65 64 20 62 79  20 47 73 69 6e 69 74 2e  |fined by Gsinit.|
00000d30  20 55 73 69 6e 67 20 47  73 69 6e 69 74 0d 74 6f  | Using Gsinit.to|
00000d40  20 69 6e 69 74 69 61 6c  69 73 65 20 61 6e 20 61  | initialise an a|
00000d50  72 67 75 6d 65 6e 74 20  61 6e 64 20 47 73 72 65  |rgument and Gsre|
00000d60  61 64 20 74 6f 20 72 65  61 64 20 69 74 20 69 73  |ad to read it is|
00000d70  20 6d 6f 72 65 20 76 65  72 73 61 74 69 6c 65 20  | more versatile |
00000d80  74 68 61 6e 0d 73 69 6d  70 6c 79 20 72 65 61 64  |than.simply read|
00000d90  69 6e 67 20 74 68 65 20  61 72 67 75 6d 65 6e 74  |ing the argument|
00000da0  20 75 73 69 6e 67 20 70  6f 73 74 2d 69 6e 64 65  | using post-inde|
00000db0  78 65 64 20 69 6e 64 69  72 65 63 74 20 61 64 64  |xed indirect add|
00000dc0  72 65 73 73 69 6e 67 0d  77 69 74 68 20 74 68 65  |ressing.with the|
00000dd0  20 74 65 78 74 20 70 6f  69 6e 74 65 72 73 2e 20  | text pointers. |
00000de0  54 68 65 20 64 69 66 66  65 72 65 6e 63 65 20 6d  |The difference m|
00000df0  61 79 20 73 65 65 6d 20  69 6e 73 69 67 6e 69 66  |ay seem insignif|
00000e00  69 63 61 6e 74 20 77 69  74 68 20 74 68 65 0d 73  |icant with the.s|
00000e10  69 6d 70 6c 65 20 65 78  61 6d 70 6c 65 20 75 73  |imple example us|
00000e20  65 64 20 61 62 6f 76 65  20 62 75 74 20 69 74 20  |ed above but it |
00000e30  69 73 20 75 73 65 66 75  6c 20 69 66 20 74 68 65  |is useful if the|
00000e40  20 61 72 67 75 6d 65 6e  74 20 69 73 20 61 20 6e  | argument is a n|
00000e50  75 6d 62 65 72 0d 77 68  65 6e 20 74 68 65 20 70  |umber.when the p|
00000e60  6c 61 63 65 20 76 61 6c  75 65 20 6f 66 20 61 20  |lace value of a |
00000e70  70 61 72 74 69 63 75 6c  61 72 20 63 68 61 72 61  |particular chara|
00000e80  63 74 65 72 20 64 65 70  65 6e 64 73 20 6f 6e 20  |cter depends on |
00000e90  69 74 73 0d 64 69 73 70  6c 61 63 65 6d 65 6e 74  |its.displacement|
00000ea0  20 66 72 6f 6d 20 74 68  65 20 74 65 72 6d 69 6e  | from the termin|
00000eb0  61 74 69 6e 67 20 63 68  61 72 61 63 74 65 72 2e  |ating character.|
00000ec0  20 52 65 61 64 69 6e 67  20 6e 75 6d 65 72 69 63  | Reading numeric|
00000ed0  61 6c 0d 61 72 67 75 6d  65 6e 74 73 20 77 69 6c  |al.arguments wil|
00000ee0  6c 20 62 65 20 63 6f 76  65 72 65 64 20 69 6e 20  |l be covered in |
00000ef0  6d 6f 64 75 6c 65 20 31  31 2e 0d 0d 20 20 42 65  |module 11...  Be|
00000f00  63 61 75 73 65 20 74 68  65 20 65 66 66 65 63 74  |cause the effect|
00000f10  20 6f 66 20 75 73 69 6e  67 20 47 73 72 65 61 64  | of using Gsread|
00000f20  20 69 73 20 76 65 72 79  20 73 69 6d 69 6c 61 72  | is very similar|
00000f30  20 74 6f 20 72 65 61 64  69 6e 67 20 61 0d 73 74  | to reading a.st|
00000f40  72 69 6e 67 20 75 73 69  6e 67 20 70 6f 73 74 2d  |ring using post-|
00000f50  69 6e 64 65 78 65 64 20  69 6e 64 69 72 65 63 74  |indexed indirect|
00000f60  20 61 64 64 72 65 73 73  69 6e 67 20 77 69 74 68  | addressing with|
00000f70  20 74 68 65 20 74 65 78  74 20 70 6f 69 6e 74 65  | the text pointe|
00000f80  72 73 0d 79 6f 75 20 6d  61 79 20 62 65 20 74 65  |rs.you may be te|
00000f90  6d 70 74 65 64 20 74 6f  20 75 73 65 20 47 73 72  |mpted to use Gsr|
00000fa0  65 61 64 20 69 6e 20 74  68 65 20 69 6e 74 65 72  |ead in the inter|
00000fb0  70 72 65 74 65 72 20 74  6f 20 72 65 61 64 20 74  |preter to read t|
00000fc0  68 65 0d 75 6e 72 65 63  6f 67 6e 69 73 65 64 20  |he.unrecognised |
00000fd0  63 6f 6d 6d 61 6e 64 2e  20 49 66 20 79 6f 75 20  |command. If you |
00000fe0  64 6f 20 79 6f 75 20 77  69 6c 6c 20 66 69 6e 64  |do you will find|
00000ff0  20 74 68 61 74 20 6d 6f  73 74 20 6f 66 20 74 68  | that most of th|
00001000  65 20 74 69 6d 65 20 69  74 0d 77 69 6c 6c 20 77  |e time it.will w|
00001010  6f 72 6b 20 62 75 74 2c  20 73 6f 6f 6e 65 72 20  |ork but, sooner |
00001020  6f 72 20 6c 61 74 65 72  2c 20 79 6f 75 20 77 69  |or later, you wi|
00001030  6c 6c 20 73 74 61 72 74  20 67 65 74 74 69 6e 67  |ll start getting|
00001040  20 6d 79 73 74 65 72 69  6f 75 73 20 22 62 61 64  | mysterious "bad|
00001050  0d 73 74 72 69 6e 67 22  20 65 72 72 6f 72 20 6d  |.string" error m|
00001060  65 73 73 61 67 65 73 2e  20 44 6f 6e 27 74 20 62  |essages. Don't b|
00001070  65 20 74 65 6d 70 74 65  64 20 69 6e 74 6f 20 77  |e tempted into w|
00001080  61 73 74 69 6e 67 20 79  6f 75 72 20 74 69 6d 65  |asting your time|
00001090  20 75 73 69 6e 67 0d 47  73 72 65 61 64 20 69 6e  | using.Gsread in|
000010a0  20 74 68 65 20 69 6e 74  65 72 70 72 65 74 65 72  | the interpreter|
000010b0  2e 20 53 74 69 63 6b 20  77 69 74 68 20 74 68 65  |. Stick with the|
000010c0  20 6d 65 74 68 6f 64 20  64 65 6d 6f 6e 73 74 72  | method demonstr|
000010d0  61 74 65 64 20 69 6e 0d  4d 6f 64 75 6c 65 20 33  |ated in.Module 3|
000010e0  2e 0d 0d 20 20 46 69 67  75 72 65 20 35 2e 32 20  |...  Figure 5.2 |
000010f0  73 68 6f 77 73 20 68 6f  77 20 74 68 65 20 69 6e  |shows how the in|
00001100  74 65 72 70 72 65 74 65  72 20 75 73 65 64 20 69  |terpreter used i|
00001110  6e 20 74 68 65 20 6c 61  73 74 20 74 77 6f 20 6d  |n the last two m|
00001120  6f 64 75 6c 65 73 0d 63  61 6e 20 62 65 20 6d 6f  |odules.can be mo|
00001130  64 69 66 69 65 64 20 74  6f 20 72 65 61 64 20 61  |dified to read a|
00001140  6e 20 61 72 67 75 6d 65  6e 74 2e 0d 0d 0d 0d 0d  |n argument......|
00001150  0d 2e 66 6f 75 6e 64 0d  20 20 20 20 20 20 20 20  |..found.        |
00001160  20 53 45 43 20 20 20 20  20 20 20 20 20 20 20 5c  | SEC           \|
00001170  20 74 65 72 6d 69 6e 61  74 65 20 77 69 74 68 20  | terminate with |
00001180  52 65 74 75 72 6e 20 6f  72 20 22 0d 20 20 20 20  |Return or ".    |
00001190  20 20 20 20 20 4a 53 52  20 26 46 46 43 32 20 20  |     JSR &FFC2  |
000011a0  20 20 20 5c 20 69 6e 69  74 69 61 6c 69 73 65 20  |   \ initialise |
000011b0  61 72 67 75 6d 65 6e 74  20 77 69 74 68 20 47 73  |argument with Gs|
000011c0  69 6e 69 74 0d 20 20 20  20 20 20 20 20 20 42 45  |init.         BE|
000011d0  51 20 65 78 69 74 20 20  20 20 20 20 5c 20 62 72  |Q exit      \ br|
000011e0  61 6e 63 68 20 69 66 20  6e 75 6c 6c 20 61 72 67  |anch if null arg|
000011f0  75 6d 65 6e 74 0d 20 20  20 20 20 20 20 20 20 4a  |ument.         J|
00001200  53 52 20 26 46 46 43 35  20 20 20 20 20 5c 20 72  |SR &FFC5     \ r|
00001210  65 61 64 20 66 69 72 73  74 20 63 68 61 72 61 63  |ead first charac|
00001220  74 65 72 20 77 69 74 68  20 47 73 72 65 61 64 0d  |ter with Gsread.|
00001230  20 20 20 20 20 20 20 20  20 42 43 53 20 65 78 69  |         BCS exi|
00001240  74 20 20 20 20 20 20 5c  20 62 72 61 6e 63 68 20  |t      \ branch |
00001250  69 66 20 65 6e 64 20 6f  66 20 61 72 67 75 6d 65  |if end of argume|
00001260  6e 74 0d 20 20 20 20 20  20 20 20 20 41 4e 44 20  |nt.         AND |
00001270  23 26 44 46 20 20 20 20  20 20 5c 20 66 6f 72 63  |#&DF      \ forc|
00001280  65 20 75 70 70 65 72 20  63 61 73 65 0d 20 20 20  |e upper case.   |
00001290  20 20 20 20 20 20 20 2e  0d 20 20 20 20 20 20 20  |       ..       |
000012a0  20 20 20 2e 0d 20 20 20  20 20 20 20 20 20 20 2e  |   ..          .|
000012b0  0d 2e 65 78 69 74 0d 20  20 20 20 20 20 20 20 20  |..exit.         |
000012c0  50 4c 41 20 20 20 20 20  20 20 20 20 20 20 5c 20  |PLA           \ |
000012d0  64 69 73 63 61 72 64 20  59 0d 20 20 20 20 20 20  |discard Y.      |
000012e0  20 20 20 50 4c 41 20 20  20 20 20 20 20 20 20 20  |   PLA          |
000012f0  20 5c 20 64 69 73 63 61  72 64 20 58 0d 20 20 20  | \ discard X.   |
00001300  20 20 20 20 20 20 50 4c  41 20 20 20 20 20 20 20  |      PLA       |
00001310  20 20 20 20 5c 20 64 69  73 63 61 72 64 20 41 0d  |    \ discard A.|
00001320  20 20 20 20 20 20 20 20  20 4c 44 41 20 23 30 20  |         LDA #0 |
00001330  20 20 20 20 20 20 20 5c  20 73 65 72 76 69 63 65  |       \ service|
00001340  20 63 61 6c 6c 20 72 65  63 6f 67 6e 69 73 65 64  | call recognised|
00001350  0d 20 20 20 20 20 20 20  20 20 52 54 53 20 20 20  |.         RTS   |
00001360  20 20 20 20 20 20 20 20  5c 20 72 65 74 75 72 6e  |        \ return|
00001370  20 74 6f 20 4d 4f 53 0d  0d 46 69 67 75 72 65 20  | to MOS..Figure |
00001380  35 2e 32 20 55 73 69 6e  67 20 47 73 69 6e 69 74  |5.2 Using Gsinit|
00001390  20 61 6e 64 20 47 73 72  65 61 64 20 74 6f 20 72  | and Gsread to r|
000013a0  65 61 64 20 61 6e 20 61  72 67 75 6d 65 6e 74 2e  |ead an argument.|
000013b0  0d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000013c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000013e0  2d 2d 2d 2d 2d 2d 2d 2d  0d 0d 0d 0d 0d 20 20 54  |--------.....  T|
000013f0  68 65 20 63 61 72 72 79  20 66 6c 61 67 20 69 73  |he carry flag is|
00001400  20 73 65 74 20 62 65 66  6f 72 65 20 63 61 6c 6c  | set before call|
00001410  69 6e 67 20 47 73 69 6e  69 74 2e 20 54 68 65 20  |ing Gsinit. The |
00001420  74 65 72 6d 69 6e 61 74  69 6e 67 0d 63 68 61 72  |terminating.char|
00001430  61 63 74 65 72 20 6f 66  20 74 68 65 20 61 72 67  |acter of the arg|
00001440  75 6d 65 6e 74 20 77 69  6c 6c 20 62 65 20 61 20  |ument will be a |
00001450  63 61 72 72 69 61 67 65  20 72 65 74 75 72 6e 20  |carriage return |
00001460  6f 72 20 61 20 73 65 63  6f 6e 64 0d 71 75 6f 74  |or a second.quot|
00001470  61 74 69 6f 6e 20 6d 61  72 6b 2e 20 41 66 74 65  |ation mark. Afte|
00001480  72 20 73 65 74 74 69 6e  67 20 74 68 65 20 63 61  |r setting the ca|
00001490  72 72 79 20 66 6c 61 67  20 47 73 69 6e 69 74 20  |rry flag Gsinit |
000014a0  69 73 20 63 61 6c 6c 65  64 20 74 6f 0d 69 6e 69  |is called to.ini|
000014b0  74 69 61 6c 69 73 65 20  74 68 65 20 61 72 67 75  |tialise the argu|
000014c0  6d 65 6e 74 2e 20 49 66  20 74 68 65 20 61 72 67  |ment. If the arg|
000014d0  75 6d 65 6e 74 20 69 73  20 6e 75 6c 6c 20 47 73  |ument is null Gs|
000014e0  69 6e 69 74 20 72 65 74  75 72 6e 73 20 77 69 74  |init returns wit|
000014f0  68 0d 74 68 65 20 7a 65  72 6f 20 66 6c 61 67 20  |h.the zero flag |
00001500  73 65 74 2e 20 54 68 69  73 20 63 61 6e 20 62 65  |set. This can be|
00001510  20 74 65 73 74 65 64 20  61 6e 64 20 62 72 61 6e  | tested and bran|
00001520  63 68 20 74 6f 20 65 78  69 74 20 69 66 20 74 68  |ch to exit if th|
00001530  65 72 65 20 69 73 0d 6e  6f 74 68 69 6e 67 20 74  |ere is.nothing t|
00001540  6f 20 72 65 61 64 2e 20  49 66 20 74 68 65 20 7a  |o read. If the z|
00001550  65 72 6f 20 66 6c 61 67  20 69 73 20 63 6c 65 61  |ero flag is clea|
00001560  72 20 74 68 65 72 65 20  69 73 20 61 6e 20 61 72  |r there is an ar|
00001570  67 75 6d 65 6e 74 20 74  6f 20 62 65 0d 72 65 61  |gument to be.rea|
00001580  64 20 62 79 20 63 61 6c  6c 69 6e 67 20 47 73 72  |d by calling Gsr|
00001590  65 61 64 20 66 6f 72 20  65 61 63 68 20 63 68 61  |ead for each cha|
000015a0  72 61 63 74 65 72 2e 20  47 73 72 65 61 64 20 77  |racter. Gsread w|
000015b0  69 6c 6c 20 72 65 74 75  72 6e 20 77 69 74 68 20  |ill return with |
000015c0  74 68 65 0d 63 61 72 72  79 20 66 6c 61 67 20 73  |the.carry flag s|
000015d0  65 74 20 77 68 65 6e 20  74 68 65 20 74 65 72 6d  |et when the term|
000015e0  69 6e 61 74 69 6e 67 20  63 68 61 72 61 63 74 65  |inating characte|
000015f0  72 20 69 73 20 72 65 61  64 20 61 6e 64 20 61 6e  |r is read and an|
00001600  0d 61 70 70 72 6f 70 72  69 61 74 65 20 62 72 61  |.appropriate bra|
00001610  6e 63 68 20 63 61 6e 20  62 65 20 6d 61 64 65 20  |nch can be made |
00001620  61 66 74 65 72 20 74 65  73 74 69 6e 67 20 74 68  |after testing th|
00001630  65 20 63 61 72 72 79 20  66 6c 61 67 2e 0d 0d 20  |e carry flag... |
00001640  20 54 68 69 73 20 6d 65  74 68 6f 64 20 6f 66 20  | This method of |
00001650  72 65 61 64 69 6e 67 20  61 6e 20 61 72 67 75 6d  |reading an argum|
00001660  65 6e 74 20 68 61 73 20  62 65 65 6e 20 75 73 65  |ent has been use|
00001670  64 20 69 6e 20 74 68 65  20 70 72 6f 67 72 61 6e  |d in the progran|
00001680  0d 43 55 52 53 4f 52 2e  20 57 68 65 6e 20 74 68  |.CURSOR. When th|
00001690  65 20 69 6e 74 65 72 70  72 65 74 65 72 20 28 6c  |e interpreter (l|
000016a0  69 6e 65 73 20 32 38 30  2d 35 34 30 29 20 72 65  |ines 280-540) re|
000016b0  63 6f 67 6e 69 73 65 73  20 74 68 65 20 63 6f 6d  |cognises the com|
000016c0  6d 61 6e 64 0d 2a 43 55  52 53 4f 52 20 69 74 20  |mand.*CURSOR it |
000016d0  70 61 73 73 65 73 20 63  6f 6e 74 72 6f 6c 20 74  |passes control t|
000016e0  6f 20 74 68 65 20 6c 61  62 65 6c 20 22 2e 66 6f  |o the label ".fo|
000016f0  75 6e 64 22 20 28 6c 69  6e 65 20 35 35 30 29 2e  |und" (line 550).|
00001700  20 54 68 65 0d 61 72 67  75 6d 65 6e 74 20 69 73  | The.argument is|
00001710  20 69 6e 69 74 69 61 6c  69 73 65 64 20 28 6c 69  | initialised (li|
00001720  6e 65 73 20 35 36 30 2d  35 37 30 29 20 61 6e 64  |nes 560-570) and|
00001730  20 74 68 65 20 61 72 67  75 6d 65 6e 74 20 69 73  | the argument is|
00001740  20 74 65 73 74 65 64 0d  28 6c 69 6e 65 20 35 38  | tested.(line 58|
00001750  30 29 2e 20 49 66 20 61  20 6e 75 6c 6c 20 61 72  |0). If a null ar|
00001760  67 75 6d 65 6e 74 20 69  73 20 64 65 74 65 63 74  |gument is detect|
00001770  65 64 20 74 68 65 20 70  72 6f 67 72 61 6d 20 72  |ed the program r|
00001780  65 74 75 72 6e 73 20 63  6f 6e 74 72 6f 6c 0d 74  |eturns control.t|
00001790  6f 20 74 68 65 20 4d 4f  53 20 77 69 74 68 20 41  |o the MOS with A|
000017a0  3d 30 20 28 6c 69 6e 65  73 20 38 36 30 2d 39 31  |=0 (lines 860-91|
000017b0  30 29 2e 20 49 66 20 61  6e 20 61 72 67 75 6d 65  |0). If an argume|
000017c0  6e 74 20 69 73 20 66 6f  75 6e 64 20 74 68 65 0d  |nt is found the.|
000017d0  70 72 6f 67 72 61 6d 20  65 78 70 65 63 74 73 20  |program expects |
000017e0  74 6f 20 72 65 61 64 20  65 69 74 68 65 72 20 4f  |to read either O|
000017f0  4e 20 6f 72 20 4f 46 46  2e 20 54 6f 20 74 65 73  |N or OFF. To tes|
00001800  74 20 66 6f 72 20 4f 4e  20 6f 72 20 4f 46 46 20  |t for ON or OFF |
00001810  74 68 65 0d 66 69 72 73  74 20 63 68 61 72 61 63  |the.first charac|
00001820  74 65 72 20 63 61 6e 20  62 65 20 73 6b 69 70 70  |ter can be skipp|
00001830  65 64 20 73 69 6e 63 65  20 69 74 20 73 68 6f 75  |ed since it shou|
00001840  6c 64 20 62 65 20 61 6e  20 22 4f 22 20 28 6c 69  |ld be an "O" (li|
00001850  6e 65 20 35 39 30 29 2e  0d 54 68 65 20 6e 65 78  |ne 590)..The nex|
00001860  74 20 63 68 61 72 61 63  74 65 72 20 69 73 20 72  |t character is r|
00001870  65 61 64 20 75 73 69 6e  67 20 47 73 72 65 61 64  |ead using Gsread|
00001880  20 28 6c 69 6e 65 20 36  30 30 29 20 61 6e 64 20  | (line 600) and |
00001890  74 65 73 74 65 64 20 66  6f 72 20 61 0d 74 65 72  |tested for a.ter|
000018a0  6d 69 6e 61 74 69 6e 67  20 63 68 61 72 61 63 74  |minating charact|
000018b0  65 72 20 28 6c 69 6e 65  20 36 31 30 29 20 61 6e  |er (line 610) an|
000018c0  64 20 65 69 74 68 65 72  20 22 46 22 20 28 6c 69  |d either "F" (li|
000018d0  6e 65 20 36 33 30 29 20  6f 72 20 22 4e 22 0d 28  |ne 630) or "N".(|
000018e0  6c 69 6e 65 20 36 35 30  29 2e 20 54 68 65 72 65  |line 650). There|
000018f0  20 69 73 20 6e 6f 20 6e  65 65 64 20 74 6f 20 72  | is no need to r|
00001900  65 61 64 20 61 6e 64 20  74 65 73 74 20 66 6f 72  |ead and test for|
00001910  20 74 68 65 20 73 65 63  6f 6e 64 20 46 20 6f 66  | the second F of|
00001920  20 4f 46 46 2e 0d 49 66  20 74 68 65 20 73 65 63  | OFF..If the sec|
00001930  6f 6e 64 20 63 68 61 72  61 63 74 65 72 20 6f 66  |ond character of|
00001940  20 74 68 65 20 61 72 67  75 6d 65 6e 74 20 69 73  | the argument is|
00001950  20 22 46 22 20 74 68 65  20 63 75 72 73 6f 72 20  | "F" the cursor |
00001960  69 73 20 73 77 69 74 63  68 65 64 0d 6f 66 66 20  |is switched.off |
00001970  28 6c 69 6e 65 73 20 36  39 30 2d 38 35 30 29 2c  |(lines 690-850),|
00001980  20 69 66 20 69 74 20 69  73 20 22 4e 22 20 74 68  | if it is "N" th|
00001990  65 20 63 75 72 73 6f 72  20 69 73 20 73 77 69 74  |e cursor is swit|
000019a0  63 68 65 64 20 6f 6e 20  28 6c 69 6e 65 73 0d 36  |ched on (lines.6|
000019b0  37 30 2d 38 35 30 29 2e  0d 0d 20 20 57 68 65 6e  |70-850)...  When|
000019c0  20 79 6f 75 20 6c 6f 61  64 20 74 68 65 20 6f 62  | you load the ob|
000019d0  6a 65 63 74 20 63 6f 64  65 20 67 65 6e 65 72 61  |ject code genera|
000019e0  74 65 64 20 62 79 20 43  55 52 53 4f 52 20 69 6e  |ted by CURSOR in|
000019f0  74 6f 20 53 57 52 20 74  6f 20 73 65 65 0d 68 6f  |to SWR to see.ho|
00001a00  77 20 69 74 20 77 6f 72  6b 73 20 69 74 20 69 73  |w it works it is|
00001a10  20 70 6f 73 73 69 62 6c  65 20 74 6f 20 64 65 63  | possible to dec|
00001a20  65 69 76 65 20 79 6f 75  72 73 65 6c 66 20 69 6e  |eive yourself in|
00001a30  74 6f 20 62 65 6c 69 65  76 69 6e 67 20 74 68 61  |to believing tha|
00001a40  74 0d 74 68 65 72 65 20  69 73 20 73 6f 6d 65 74  |t.there is somet|
00001a50  68 69 6e 67 20 77 72 6f  6e 67 20 77 69 74 68 20  |hing wrong with |
00001a60  69 74 2e 20 49 66 20 79  6f 75 20 74 79 70 65 20  |it. If you type |
00001a70  2a 43 55 52 53 4f 52 20  4f 46 46 20 61 6e 64 20  |*CURSOR OFF and |
00001a80  70 72 65 73 73 0d 52 65  74 75 72 6e 20 74 68 65  |press.Return the|
00001a90  20 63 75 72 73 6f 72 20  77 69 6c 6c 20 67 6f 20  | cursor will go |
00001aa0  6f 66 66 20 61 73 20 65  78 70 65 63 74 65 64 2e  |off as expected.|
00001ab0  20 54 79 70 65 20 2a 43  55 52 53 4f 52 20 4f 4e  | Type *CURSOR ON|
00001ac0  20 61 6e 64 20 69 74 20  77 69 6c 6c 0d 63 6f 6d  | and it will.com|
00001ad0  65 20 62 61 63 6b 20 6f  6e 2e 20 45 76 65 72 79  |e back on. Every|
00001ae0  74 68 69 6e 67 20 73 65  65 6d 73 20 4f 4b 2e 20  |thing seems OK. |
00001af0  54 79 70 65 20 2a 43 55  52 53 4f 52 20 4f 46 46  |Type *CURSOR OFF|
00001b00  20 61 6e 64 20 52 65 74  75 72 6e 20 61 6e 64 0d  | and Return and.|
00001b10  74 68 65 6e 20 74 79 70  65 20 2a 43 55 52 53 4f  |then type *CURSO|
00001b20  52 20 61 6e 64 20 52 65  74 75 72 6e 2e 20 54 68  |R and Return. Th|
00001b30  65 20 63 75 72 73 6f 72  20 73 74 61 79 73 20 6f  |e cursor stays o|
00001b40  66 66 20 62 65 63 61 75  73 65 20 79 6f 75 20 68  |ff because you h|
00001b50  61 76 65 0d 6e 6f 74 20  74 79 70 65 64 20 61 6e  |ave.not typed an|
00001b60  20 61 72 67 75 6d 65 6e  74 2e 20 45 76 65 72 79  | argument. Every|
00001b70  74 68 69 6e 67 20 69 73  20 73 74 69 6c 6c 20 4f  |thing is still O|
00001b80  4b 2e 20 4e 6f 77 20 75  73 65 20 74 68 65 20 63  |K. Now use the c|
00001b90  75 72 73 6f 72 20 6b 65  79 73 0d 74 6f 20 63 6f  |ursor keys.to co|
00001ba0  70 79 20 74 68 65 20 2a  43 55 52 53 4f 52 20 63  |py the *CURSOR c|
00001bb0  6f 6d 6d 61 6e 64 20 77  69 74 68 6f 75 74 20 61  |ommand without a|
00001bc0  6e 20 61 72 67 75 6d 65  6e 74 20 61 6e 64 20 70  |n argument and p|
00001bd0  72 65 73 73 20 52 65 74  75 72 6e 2e 20 54 68 65  |ress Return. The|
00001be0  0d 63 75 72 73 6f 72 20  63 6f 6d 65 73 20 62 61  |.cursor comes ba|
00001bf0  63 6b 20 6f 6e 20 77 68  65 6e 20 69 74 20 73 68  |ck on when it sh|
00001c00  6f 75 6c 64 20 68 61 76  65 20 73 74 61 79 65 64  |ould have stayed|
00001c10  20 6f 66 66 2e 20 54 68  69 73 20 77 69 6c 6c 20  | off. This will |
00001c20  68 61 70 70 65 6e 0d 62  65 63 61 75 73 65 20 79  |happen.because y|
00001c30  6f 75 20 77 69 6c 6c 20  72 65 2d 65 6e 61 62 6c  |ou will re-enabl|
00001c40  65 20 74 68 65 20 63 75  72 73 6f 72 20 77 69 74  |e the cursor wit|
00001c50  68 20 74 68 65 20 63 75  72 73 6f 72 20 6b 65 79  |h the cursor key|
00001c60  73 2e 20 54 68 65 72 65  20 69 73 0d 6e 6f 74 68  |s. There is.noth|
00001c70  69 6e 67 20 77 72 6f 6e  67 20 77 69 74 68 20 74  |ing wrong with t|
00001c80  68 65 20 61 72 67 75 6d  65 6e 74 20 72 65 61 64  |he argument read|
00001c90  69 6e 67 20 74 65 63 68  6e 69 71 75 65 20 64 65  |ing technique de|
00001ca0  6d 6f 6e 73 74 72 61 74  65 64 20 69 6e 20 74 68  |monstrated in th|
00001cb0  65 0d 70 72 6f 67 72 61  6d 2e 0d 0d 0d 0d 0d 0d  |e.program.......|
00001cc0  20 20 20 31 30 20 52 45  4d 3a 20 43 55 52 53 4f  |   10 REM: CURSO|
00001cd0  52 0d 20 20 20 32 30 20  4d 4f 44 45 37 0d 20 20  |R.   20 MODE7.  |
00001ce0  20 33 30 20 48 49 4d 45  4d 3d 26 33 43 30 30 0d  | 30 HIMEM=&3C00.|
00001cf0  20 20 20 34 30 20 44 49  4d 20 73 61 76 65 20 35  |   40 DIM save 5|
00001d00  30 0d 20 20 20 35 30 20  64 69 66 66 3d 26 38 30  |0.   50 diff=&80|
00001d10  30 30 2d 48 49 4d 45 4d  0d 20 20 20 36 30 20 63  |00-HIMEM.   60 c|
00001d20  6f 6d 76 65 63 3d 26 46  32 0d 20 20 20 37 30 20  |omvec=&F2.   70 |
00001d30  67 73 69 6e 69 74 3d 26  46 46 43 32 0d 20 20 20  |gsinit=&FFC2.   |
00001d40  38 30 20 67 73 72 65 61  64 3d 26 46 46 43 35 0d  |80 gsread=&FFC5.|
00001d50  20 20 20 39 30 20 6f 73  61 73 63 69 3d 26 46 46  |   90 osasci=&FF|
00001d60  45 33 0d 20 20 31 30 30  20 6f 73 63 6c 69 3d 26  |E3.  100 oscli=&|
00001d70  46 46 46 37 0d 20 20 31  31 30 20 46 4f 52 20 70  |FFF7.  110 FOR p|
00001d80  61 73 73 20 3d 20 30 20  54 4f 20 32 20 53 54 45  |ass = 0 TO 2 STE|
00001d90  50 20 32 0d 20 20 31 32  30 20 50 25 3d 48 49 4d  |P 2.  120 P%=HIM|
00001da0  45 4d 0d 20 20 31 33 30  20 5b 20 20 20 20 20 20  |EM.  130 [      |
00001db0  20 4f 50 54 20 70 61 73  73 0d 20 20 31 34 30 20  | OPT pass.  140 |
00001dc0  20 20 20 20 20 20 20 20  42 52 4b 0d 20 20 31 35  |        BRK.  15|
00001dd0  30 20 20 20 20 20 20 20  20 20 42 52 4b 0d 20 20  |0         BRK.  |
00001de0  31 36 30 20 20 20 20 20  20 20 20 20 42 52 4b 0d  |160         BRK.|
00001df0  20 20 31 37 30 20 20 20  20 20 20 20 20 20 4a 4d  |  170         JM|
00001e00  50 20 73 65 72 76 69 63  65 2b 64 69 66 66 0d 20  |P service+diff. |
00001e10  20 31 38 30 20 20 20 20  20 20 20 20 20 4f 50 54  | 180         OPT|
00001e20  20 46 4e 65 71 75 62 28  26 38 32 29 0d 20 20 31  | FNequb(&82).  1|
00001e30  39 30 20 20 20 20 20 20  20 20 20 4f 50 54 20 46  |90         OPT F|
00001e40  4e 65 71 75 62 28 28 63  6f 70 79 72 69 67 68 74  |Nequb((copyright|
00001e50  2b 64 69 66 66 29 20 4d  4f 44 20 32 35 36 29 0d  |+diff) MOD 256).|
00001e60  20 20 32 30 30 20 20 20  20 20 20 20 20 20 42 52  |  200         BR|
00001e70  4b 0d 20 20 32 31 30 20  2e 74 69 74 6c 65 0d 20  |K.  210 .title. |
00001e80  20 32 32 30 20 20 20 20  20 20 20 20 20 4f 50 54  | 220         OPT|
00001e90  20 46 4e 65 71 75 73 28  22 43 55 52 53 4f 52 22  | FNequs("CURSOR"|
00001ea0  29 0d 20 20 32 33 30 20  2e 63 6f 70 79 72 69 67  |).  230 .copyrig|
00001eb0  68 74 0d 20 20 32 34 30  20 20 20 20 20 20 20 20  |ht.  240        |
00001ec0  20 42 52 4b 0d 20 20 32  35 30 20 20 20 20 20 20  | BRK.  250      |
00001ed0  20 20 20 4f 50 54 20 46  4e 65 71 75 73 28 22 28  |   OPT FNequs("(|
00001ee0  43 29 20 47 6f 72 64 6f  6e 20 48 6f 72 73 69 6e  |C) Gordon Horsin|
00001ef0  67 74 6f 6e 20 31 39 38  37 22 29 0d 20 20 32 36  |gton 1987").  26|
00001f00  30 20 20 20 20 20 20 20  20 20 42 52 4b 0d 20 20  |0         BRK.  |
00001f10  32 37 30 20 2e 73 65 72  76 69 63 65 0d 20 20 32  |270 .service.  2|
00001f20  38 30 20 20 20 20 20 20  20 20 20 43 4d 50 20 23  |80         CMP #|
00001f30  34 0d 20 20 32 39 30 20  20 20 20 20 20 20 20 20  |4.  290         |
00001f40  42 45 51 20 75 6e 72 65  63 6f 67 6e 69 73 65 64  |BEQ unrecognised|
00001f50  0d 20 20 33 30 30 20 20  20 20 20 20 20 20 20 52  |.  300         R|
00001f60  54 53 0d 20 20 33 31 30  20 2e 75 6e 72 65 63 6f  |TS.  310 .unreco|
00001f70  67 6e 69 73 65 64 0d 20  20 33 32 30 20 20 20 20  |gnised.  320    |
00001f80  20 20 20 20 20 50 48 41  0d 20 20 33 33 30 20 20  |     PHA.  330  |
00001f90  20 20 20 20 20 20 20 54  58 41 0d 20 20 33 34 30  |       TXA.  340|
00001fa0  20 20 20 20 20 20 20 20  20 50 48 41 0d 20 20 33  |         PHA.  3|
00001fb0  35 30 20 20 20 20 20 20  20 20 20 54 59 41 0d 20  |50         TYA. |
00001fc0  20 33 36 30 20 20 20 20  20 20 20 20 20 50 48 41  | 360         PHA|
00001fd0  0d 20 20 33 37 30 20 20  20 20 20 20 20 20 20 4c  |.  370         L|
00001fe0  44 58 20 23 26 46 46 0d  20 20 33 38 30 20 2e 63  |DX #&FF.  380 .c|
00001ff0  6f 6d 6c 6f 6f 70 0d 20  20 33 39 30 20 20 20 20  |omloop.  390    |
00002000  20 20 20 20 20 49 4e 58  0d 20 20 34 30 30 20 20  |     INX.  400  |
00002010  20 20 20 20 20 20 20 4c  44 41 20 74 69 74 6c 65  |       LDA title|
00002020  2b 64 69 66 66 2c 58 0d  20 20 34 31 30 20 20 20  |+diff,X.  410   |
00002030  20 20 20 20 20 20 42 45  51 20 66 6f 75 6e 64 0d  |      BEQ found.|
00002040  20 20 34 32 30 20 20 20  20 20 20 20 20 20 4c 44  |  420         LD|
00002050  41 20 28 63 6f 6d 76 65  63 29 2c 59 0d 20 20 34  |A (comvec),Y.  4|
00002060  33 30 20 20 20 20 20 20  20 20 20 49 4e 59 0d 20  |30         INY. |
00002070  20 34 34 30 20 20 20 20  20 20 20 20 20 43 4d 50  | 440         CMP|
00002080  20 23 41 53 43 28 22 2e  22 29 0d 20 20 34 35 30  | #ASC(".").  450|
00002090  20 20 20 20 20 20 20 20  20 42 45 51 20 66 6f 75  |         BEQ fou|
000020a0  6e 64 0d 20 20 34 36 30  20 20 20 20 20 20 20 20  |nd.  460        |
000020b0  20 41 4e 44 20 23 26 44  46 0d 20 20 34 37 30 20  | AND #&DF.  470 |
000020c0  20 20 20 20 20 20 20 20  43 4d 50 20 74 69 74 6c  |        CMP titl|
000020d0  65 2b 64 69 66 66 2c 58  0d 20 20 34 38 30 20 20  |e+diff,X.  480  |
000020e0  20 20 20 20 20 20 20 42  45 51 20 63 6f 6d 6c 6f  |       BEQ comlo|
000020f0  6f 70 0d 20 20 34 39 30  20 20 20 20 20 20 20 20  |op.  490        |
00002100  20 50 4c 41 0d 20 20 35  30 30 20 20 20 20 20 20  | PLA.  500      |
00002110  20 20 20 54 41 59 0d 20  20 35 31 30 20 20 20 20  |   TAY.  510    |
00002120  20 20 20 20 20 50 4c 41  0d 20 20 35 32 30 20 20  |     PLA.  520  |
00002130  20 20 20 20 20 20 20 54  41 58 0d 20 20 35 33 30  |       TAX.  530|
00002140  20 20 20 20 20 20 20 20  20 50 4c 41 0d 20 20 35  |         PLA.  5|
00002150  34 30 20 20 20 20 20 20  20 20 20 52 54 53 0d 20  |40         RTS. |
00002160  20 35 35 30 20 2e 66 6f  75 6e 64 0d 20 20 35 36  | 550 .found.  56|
00002170  30 20 20 20 20 20 20 20  20 20 53 45 43 20 20 20  |0         SEC   |
00002180  20 20 20 20 20 20 20 20  5c 20 54 65 72 6d 69 6e  |        \ Termin|
00002190  61 74 65 20 77 69 74 68  20 52 65 74 75 72 6e 20  |ate with Return |
000021a0  6f 72 20 22 0d 20 20 35  37 30 20 20 20 20 20 20  |or ".  570      |
000021b0  20 20 20 4a 53 52 20 67  73 69 6e 69 74 0d 20 20  |   JSR gsinit.  |
000021c0  35 38 30 20 20 20 20 20  20 20 20 20 42 45 51 20  |580         BEQ |
000021d0  65 78 69 74 20 20 20 20  20 20 5c 20 42 72 61 6e  |exit      \ Bran|
000021e0  63 68 20 69 66 20 6e 75  6c 6c 20 61 72 67 75 6d  |ch if null argum|
000021f0  65 6e 74 0d 20 20 35 39  30 20 20 20 20 20 20 20  |ent.  590       |
00002200  20 20 49 4e 59 20 20 20  20 20 20 20 20 20 20 20  |  INY           |
00002210  5c 20 46 69 72 73 74 20  63 68 61 72 61 63 74 65  |\ First characte|
00002220  72 20 6d 75 73 74 20 62  65 20 22 4f 22 0d 20 20  |r must be "O".  |
00002230  36 30 30 20 20 20 20 20  20 20 20 20 4a 53 52 20  |600         JSR |
00002240  67 73 72 65 61 64 20 20  20 20 5c 20 53 65 63 6f  |gsread    \ Seco|
00002250  6e 64 20 63 68 61 72 61  63 74 65 72 20 22 46 22  |nd character "F"|
00002260  20 6f 72 20 22 4e 22 0d  20 20 36 31 30 20 20 20  | or "N".  610   |
00002270  20 20 20 20 20 20 42 43  53 20 65 78 69 74 20 20  |      BCS exit  |
00002280  20 20 20 20 5c 20 42 72  61 6e 63 68 20 69 66 20  |    \ Branch if |
00002290  65 6e 64 20 6f 66 20 61  72 67 75 6d 65 6e 74 0d  |end of argument.|
000022a0  20 20 36 32 30 20 20 20  20 20 20 20 20 20 41 4e  |  620         AN|
000022b0  44 20 23 26 44 46 20 20  20 20 20 20 5c 20 55 70  |D #&DF      \ Up|
000022c0  70 65 72 20 63 61 73 65  0d 20 20 36 33 30 20 20  |per case.  630  |
000022d0  20 20 20 20 20 20 20 43  4d 50 20 23 41 53 43 28  |       CMP #ASC(|
000022e0  22 46 22 29 0d 20 20 36  34 30 20 20 20 20 20 20  |"F").  640      |
000022f0  20 20 20 42 45 51 20 63  75 72 73 6f 72 6f 66 66  |   BEQ cursoroff|
00002300  0d 20 20 36 35 30 20 20  20 20 20 20 20 20 20 43  |.  650         C|
00002310  4d 50 20 23 41 53 43 28  22 4e 22 29 0d 20 20 36  |MP #ASC("N").  6|
00002320  36 30 20 20 20 20 20 20  20 20 20 42 4e 45 20 65  |60         BNE e|
00002330  78 69 74 0d 20 20 36 37  30 20 20 20 20 20 20 20  |xit.  670       |
00002340  20 20 53 45 43 0d 20 20  36 38 30 20 20 20 20 20  |  SEC.  680     |
00002350  20 20 20 20 42 43 53 20  63 75 72 73 6f 72 0d 20  |    BCS cursor. |
00002360  20 36 39 30 20 2e 63 75  72 73 6f 72 6f 66 66 0d  | 690 .cursoroff.|
00002370  20 20 37 30 30 20 20 20  20 20 20 20 20 20 43 4c  |  700         CL|
00002380  43 0d 20 20 37 31 30 20  2e 63 75 72 73 6f 72 0d  |C.  710 .cursor.|
00002390  20 20 37 32 30 20 20 20  20 20 20 20 20 20 50 48  |  720         PH|
000023a0  50 0d 20 20 37 33 30 20  20 20 20 20 20 20 20 20  |P.  730         |
000023b0  4c 44 41 20 23 32 33 0d  20 20 37 34 30 20 20 20  |LDA #23.  740   |
000023c0  20 20 20 20 20 20 4a 53  52 20 6f 73 61 73 63 69  |      JSR osasci|
000023d0  0d 20 20 37 35 30 20 20  20 20 20 20 20 20 20 4c  |.  750         L|
000023e0  44 41 20 23 31 0d 20 20  37 36 30 20 20 20 20 20  |DA #1.  760     |
000023f0  20 20 20 20 4a 53 52 20  6f 73 61 73 63 69 0d 20  |    JSR osasci. |
00002400  20 37 37 30 20 20 20 20  20 20 20 20 20 50 4c 41  | 770         PLA|
00002410  0d 20 20 37 38 30 20 20  20 20 20 20 20 20 20 41  |.  780         A|
00002420  4e 44 20 23 31 0d 20 20  37 39 30 20 20 20 20 20  |ND #1.  790     |
00002430  20 20 20 20 4a 53 52 20  6f 73 61 73 63 69 0d 20  |    JSR osasci. |
00002440  20 38 30 30 20 20 20 20  20 20 20 20 20 4c 44 41  | 800         LDA|
00002450  20 23 30 0d 20 20 38 31  30 20 20 20 20 20 20 20  | #0.  810       |
00002460  20 20 4c 44 58 20 23 37  0d 20 20 38 32 30 20 2e  |  LDX #7.  820 .|
00002470  63 75 72 73 6f 72 6c 6f  6f 70 0d 20 20 38 33 30  |cursorloop.  830|
00002480  20 20 20 20 20 20 20 20  20 4a 53 52 20 6f 73 61  |         JSR osa|
00002490  73 63 69 0d 20 20 38 34  30 20 20 20 20 20 20 20  |sci.  840       |
000024a0  20 20 44 45 58 0d 20 20  38 35 30 20 20 20 20 20  |  DEX.  850     |
000024b0  20 20 20 20 42 4e 45 20  63 75 72 73 6f 72 6c 6f  |    BNE cursorlo|
000024c0  6f 70 0d 20 20 38 36 30  20 2e 65 78 69 74 0d 20  |op.  860 .exit. |
000024d0  20 38 37 30 20 20 20 20  20 20 20 20 20 50 4c 41  | 870         PLA|
000024e0  0d 20 20 38 38 30 20 20  20 20 20 20 20 20 20 50  |.  880         P|
000024f0  4c 41 0d 20 20 38 39 30  20 20 20 20 20 20 20 20  |LA.  890        |
00002500  20 50 4c 41 0d 20 20 39  30 30 20 20 20 20 20 20  | PLA.  900      |
00002510  20 20 20 4c 44 41 20 23  30 0d 20 20 39 31 30 20  |   LDA #0.  910 |
00002520  20 20 20 20 20 20 20 20  52 54 53 0d 20 20 39 32  |        RTS.  92|
00002530  30 20 2e 6c 61 73 74 62  79 74 65 0d 20 20 39 33  |0 .lastbyte.  93|
00002540  30 20 5d 0d 20 20 39 34  30 20 4e 45 58 54 0d 20  |0 ].  940 NEXT. |
00002550  20 39 35 30 20 49 4e 50  55 54 27 22 53 61 76 65  | 950 INPUT'"Save|
00002560  20 66 69 6c 65 6e 61 6d  65 20 3d 20 22 66 69 6c  | filename = "fil|
00002570  65 6e 61 6d 65 24 0d 20  20 39 36 30 20 49 46 20  |ename$.  960 IF |
00002580  66 69 6c 65 6e 61 6d 65  24 3d 22 22 20 45 4e 44  |filename$="" END|
00002590  0d 20 20 39 37 30 20 24  73 61 76 65 3d 22 53 41  |.  970 $save="SA|
000025a0  56 45 20 22 2b 66 69 6c  65 6e 61 6d 65 24 2b 22  |VE "+filename$+"|
000025b0  20 22 2b 53 54 52 24 7e  28 48 49 4d 45 4d 29 2b  | "+STR$~(HIMEM)+|
000025c0  22 20 22 2b 53 54 52 24  7e 28 6c 61 73 0d 20 20  |" "+STR$~(las.  |
000025d0  20 20 20 20 74 62 79 74  65 29 2b 22 20 46 46 46  |    tbyte)+" FFF|
000025e0  46 38 30 30 30 20 46 46  46 46 38 30 30 30 22 0d  |F8000 FFFF8000".|
000025f0  20 20 39 38 30 20 58 25  3d 73 61 76 65 20 4d 4f  |  980 X%=save MO|
00002600  44 20 32 35 36 0d 20 20  39 39 30 20 59 25 3d 73  |D 256.  990 Y%=s|
00002610  61 76 65 20 44 49 56 20  32 35 36 0d 20 31 30 30  |ave DIV 256. 100|
00002620  30 20 2a 4f 50 54 31 2c  32 0d 20 31 30 31 30 20  |0 *OPT1,2. 1010 |
00002630  43 41 4c 4c 20 6f 73 63  6c 69 0d 20 31 30 32 30  |CALL oscli. 1020|
00002640  20 2a 4f 50 54 31 2c 30  0d 20 31 30 33 30 20 45  | *OPT1,0. 1030 E|
00002650  4e 44 0d 20 31 30 34 30  20 44 45 46 46 4e 65 71  |ND. 1040 DEFFNeq|
00002660  75 62 28 62 79 74 65 29  0d 20 31 30 35 30 20 3f  |ub(byte). 1050 ?|
00002670  50 25 3d 62 79 74 65 0d  20 31 30 36 30 20 50 25  |P%=byte. 1060 P%|
00002680  3d 50 25 2b 31 0d 20 31  30 37 30 20 3d 70 61 73  |=P%+1. 1070 =pas|
00002690  73 0d 20 31 30 38 30 20  44 45 46 46 4e 65 71 75  |s. 1080 DEFFNequ|
000026a0  77 28 77 6f 72 64 29 0d  20 31 30 39 30 20 3f 50  |w(word). 1090 ?P|
000026b0  25 3d 77 6f 72 64 20 4d  4f 44 20 32 35 36 0d 20  |%=word MOD 256. |
000026c0  31 31 30 30 20 50 25 3f  31 3d 77 6f 72 64 20 44  |1100 P%?1=word D|
000026d0  49 56 20 32 35 36 0d 20  31 31 31 30 20 50 25 3d  |IV 256. 1110 P%=|
000026e0  50 25 2b 32 0d 20 31 31  32 30 20 3d 70 61 73 73  |P%+2. 1120 =pass|
000026f0  0d 20 31 31 33 30 20 44  45 46 46 4e 65 71 75 64  |. 1130 DEFFNequd|
00002700  28 64 6f 75 62 6c 65 29  0d 20 31 31 34 30 20 21  |(double). 1140 !|
00002710  50 25 3d 64 6f 75 62 6c  65 0d 20 31 31 35 30 20  |P%=double. 1150 |
00002720  50 25 3d 50 25 2b 34 0d  20 31 31 36 30 20 3d 70  |P%=P%+4. 1160 =p|
00002730  61 73 73 0d 20 31 31 37  30 20 44 45 46 46 4e 65  |ass. 1170 DEFFNe|
00002740  71 75 73 28 73 74 72 69  6e 67 24 29 0d 20 31 31  |qus(string$). 11|
00002750  38 30 20 24 50 25 3d 73  74 72 69 6e 67 24 0d 20  |80 $P%=string$. |
00002760  31 31 39 30 20 50 25 3d  50 25 2b 4c 45 4e 28 73  |1190 P%=P%+LEN(s|
00002770  74 72 69 6e 67 24 29 0d  20 31 32 30 30 20 3d 70  |tring$). 1200 =p|
00002780  61 73 73 0d                                       |ass.|
00002784
05-08-88/T\SWR_OLD
00000000  4d 61 73 74 65 72 69 6e  67 20 53 69 64 65 77 61  |Mastering Sidewa|
00000010  79 73 20 52 4f 4d 20 26  20 52 41 4d 20 2d 20 4d  |ys ROM & RAM - M|
00000020  6f 64 75 6c 65 20 30 35  20 2d 20 52 65 61 64 69  |odule 05 - Readi|
00000030  6e 67 20 61 72 67 75 6d  65 6e 74 73 0d 2d 2d 2d  |ng arguments.---|
00000040  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000070  2d 2d 2d 2d 2d 2d 2d 2d  2d 0d 0d 20 20 49 6e 20  |---------..  In |
00000080  74 68 69 73 20 6d 6f 64  75 6c 65 20 49 20 77 69  |this module I wi|
00000090  6c 6c 20 65 78 74 65 6e  64 20 74 68 65 20 69 6e  |ll extend the in|
000000a0  74 65 72 70 72 65 74 65  72 20 69 6e 74 72 6f 64  |terpreter introd|
000000b0  75 63 65 64 20 69 6e 20  4d 6f 64 75 6c 65 20 33  |uced in Module 3|
000000c0  0d 74 6f 20 69 6e 63 6c  75 64 65 20 72 65 61 64  |.to include read|
000000d0  69 6e 67 20 61 72 67 75  6d 65 6e 74 73 20 77 68  |ing arguments wh|
000000e0  69 63 68 20 66 6f 6c 6c  6f 77 20 74 68 65 20 2a  |ich follow the *|
000000f0  20 63 6f 6d 6d 61 6e 64  2e 0d 0d 20 20 54 68 65  | command...  The|
00000100  72 65 20 61 72 65 20 74  77 6f 20 4d 4f 53 20 73  |re are two MOS s|
00000110  75 62 72 6f 75 74 69 6e  65 73 20 75 73 65 64 20  |ubroutines used |
00000120  74 6f 20 72 65 61 64 20  61 72 67 75 6d 65 6e 74  |to read argument|
00000130  73 2e 20 54 68 65 79 20  61 72 65 0d 47 73 69 6e  |s. They are.Gsin|
00000140  69 74 20 61 74 20 26 46  46 43 32 20 61 6e 64 20  |it at &FFC2 and |
00000150  47 73 72 65 61 64 20 61  74 20 26 46 46 43 35 2e  |Gsread at &FFC5.|
00000160  0d 0d 20 20 47 73 69 6e  69 74 20 73 68 6f 75 6c  |..  Gsinit shoul|
00000170  64 20 62 65 20 75 73 65  64 20 74 6f 20 69 6e 69  |d be used to ini|
00000180  74 69 61 6c 69 73 65 20  61 6e 20 61 72 67 75 6d  |tialise an argum|
00000190  65 6e 74 20 77 68 69 63  68 20 69 73 20 74 6f 20  |ent which is to |
000001a0  62 65 20 72 65 61 64 0d  75 73 69 6e 67 20 47 73  |be read.using Gs|
000001b0  72 65 61 64 2e 20 47 73  69 6e 69 74 20 75 73 65  |read. Gsinit use|
000001c0  73 20 74 68 65 20 74 65  78 74 20 70 6f 69 6e 74  |s the text point|
000001d0  65 72 73 20 61 74 20 26  46 32 20 61 6e 64 20 26  |ers at &F2 and &|
000001e0  46 33 20 77 69 74 68 20  61 6e 0d 6f 66 66 73 65  |F3 with an.offse|
000001f0  74 20 69 6e 20 74 68 65  20 59 20 72 65 67 69 73  |t in the Y regis|
00000200  74 65 72 20 74 6f 20 69  64 65 6e 74 69 66 79 20  |ter to identify |
00000210  74 68 65 20 61 72 67 75  6d 65 6e 74 20 61 64 64  |the argument add|
00000220  72 65 73 73 2e 20 54 68  65 0d 61 72 67 75 6d 65  |ress. The.argume|
00000230  6e 74 20 63 61 6e 20 62  65 20 65 6e 63 6c 6f 73  |nt can be enclos|
00000240  65 64 20 62 79 20 71 75  6f 74 61 74 69 6f 6e 20  |ed by quotation |
00000250  6d 61 72 6b 73 20 62 75  74 20 69 74 20 64 6f 65  |marks but it doe|
00000260  73 20 6e 6f 74 20 68 61  76 65 20 74 6f 0d 62 65  |s not have to.be|
00000270  2e 20 47 73 69 6e 69 74  20 69 73 20 75 73 65 64  |. Gsinit is used|
00000280  20 74 6f 20 73 74 72 69  70 20 6f 66 66 20 61 6e  | to strip off an|
00000290  79 20 6c 65 61 64 69 6e  67 20 73 70 61 63 65 73  |y leading spaces|
000002a0  20 61 6e 64 20 74 6f 20  73 65 74 20 75 70 20 61  | and to set up a|
000002b0  6e 0d 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 62 79  |n.information by|
000002c0  74 65 20 69 6e 20 7a 65  72 6f 20 70 61 67 65 20  |te in zero page |
000002d0  77 68 69 63 68 20 69 6e  64 69 63 61 74 65 73 20  |which indicates |
000002e0  74 68 65 20 74 65 72 6d  69 6e 61 74 69 6f 6e 0d  |the termination.|
000002f0  63 68 61 72 61 63 74 65  72 20 6f 66 20 74 68 65  |character of the|
00000300  20 61 72 67 75 6d 65 6e  74 2e 0d 0d 20 20 42 65  | argument...  Be|
00000310  66 6f 72 65 20 63 61 6c  6c 69 6e 67 20 47 73 69  |fore calling Gsi|
00000320  6e 69 74 20 79 6f 75 20  73 68 6f 75 6c 64 20 63  |nit you should c|
00000330  6c 65 61 72 20 74 68 65  20 63 61 72 72 79 20 66  |lear the carry f|
00000340  6c 61 67 20 69 66 20 79  6f 75 20 77 61 6e 74 0d  |lag if you want.|
00000350  74 68 65 20 73 65 63 6f  6e 64 20 71 75 6f 74 61  |the second quota|
00000360  74 69 6f 6e 20 6d 61 72  6b 2c 20 74 68 65 20 66  |tion mark, the f|
00000370  69 72 73 74 20 73 70 61  63 65 20 77 69 74 68 69  |irst space withi|
00000380  6e 20 74 68 65 20 61 72  67 75 6d 65 6e 74 2c 20  |n the argument, |
00000390  6f 72 20 61 0d 63 61 72  72 69 61 67 65 20 72 65  |or a.carriage re|
000003a0  74 75 72 6e 20 61 73 20  74 68 65 20 74 65 72 6d  |turn as the term|
000003b0  69 6e 61 74 69 6e 67 20  63 68 61 72 61 63 74 65  |inating characte|
000003c0  72 2e 20 59 6f 75 20 73  68 6f 75 6c 64 20 73 65  |r. You should se|
000003d0  74 20 74 68 65 20 63 61  72 72 79 0d 66 6c 61 67  |t the carry.flag|
000003e0  20 62 65 66 6f 72 65 20  63 61 6c 6c 69 6e 67 20  | before calling |
000003f0  47 73 69 6e 69 74 20 69  66 20 79 6f 75 20 64 6f  |Gsinit if you do|
00000400  20 6e 6f 74 20 77 61 6e  74 20 61 20 73 70 61 63  | not want a spac|
00000410  65 20 74 6f 20 62 65 20  72 65 63 6f 67 6e 69 73  |e to be recognis|
00000420  65 64 0d 61 73 20 61 20  74 65 72 6d 69 6e 61 74  |ed.as a terminat|
00000430  69 6e 67 20 63 68 61 72  61 63 74 65 72 2e 20 49  |ing character. I|
00000440  66 20 69 6e 20 64 6f 75  62 74 2c 20 73 65 74 20  |f in doubt, set |
00000450  74 68 65 20 63 61 72 72  79 20 66 6c 61 67 20 62  |the carry flag b|
00000460  65 66 6f 72 65 0d 63 61  6c 6c 69 6e 67 20 47 73  |efore.calling Gs|
00000470  69 6e 69 74 2e 0d 0d 20  20 41 66 74 65 72 20 63  |init...  After c|
00000480  61 6c 6c 69 6e 67 20 47  73 69 6e 69 74 20 74 68  |alling Gsinit th|
00000490  65 20 59 20 72 65 67 69  73 74 65 72 20 63 6f 6e  |e Y register con|
000004a0  74 61 69 6e 73 20 61 6e  20 6f 66 66 73 65 74 20  |tains an offset |
000004b0  74 6f 20 74 68 65 20 66  69 72 73 74 0d 63 68 61  |to the first.cha|
000004c0  72 61 63 74 65 72 20 6f  66 20 74 68 65 20 61 72  |racter of the ar|
000004d0  67 75 6d 65 6e 74 20 61  6e 64 20 74 68 65 20 61  |gument and the a|
000004e0  63 63 75 6d 75 6c 61 74  6f 72 20 63 6f 6e 74 61  |ccumulator conta|
000004f0  69 6e 73 20 74 68 65 20  66 69 72 73 74 0d 63 68  |ins the first.ch|
00000500  61 72 61 63 74 65 72 20  6f 66 20 74 68 65 20 61  |aracter of the a|
00000510  72 67 75 6d 65 6e 74 2e  20 54 68 65 20 7a 65 72  |rgument. The zer|
00000520  6f 20 66 6c 61 67 20 69  73 20 73 65 74 20 69 66  |o flag is set if|
00000530  20 74 68 65 20 61 72 67  75 6d 65 6e 74 20 69 73  | the argument is|
00000540  20 61 0d 6e 75 6c 6c 20  73 74 72 69 6e 67 2e 0d  | a.null string..|
00000550  0d 20 20 46 6f 72 20 65  78 61 6d 70 6c 65 2c 20  |.  For example, |
00000560  69 6d 61 67 69 6e 65 20  79 6f 75 20 68 61 76 65  |imagine you have|
00000570  20 74 79 70 65 64 20 2a  43 55 52 53 4f 52 20 4f  | typed *CURSOR O|
00000580  4e 20 61 6e 64 20 74 68  65 20 69 6e 74 65 72 70  |N and the interp|
00000590  72 65 74 65 72 0d 68 61  73 20 72 65 63 6f 67 6e  |reter.has recogn|
000005a0  69 73 65 64 20 74 68 65  20 63 6f 6d 6d 61 6e 64  |ised the command|
000005b0  20 43 55 52 53 4f 52 2e  20 42 65 66 6f 72 65 20  | CURSOR. Before |
000005c0  63 61 6c 6c 69 6e 67 20  47 73 69 6e 69 74 2c 20  |calling Gsinit, |
000005d0  74 68 65 20 74 65 78 74  0d 70 6f 69 6e 74 65 72  |the text.pointer|
000005e0  73 20 61 74 20 26 46 32  20 61 6e 64 20 26 46 33  |s at &F2 and &F3|
000005f0  20 77 69 6c 6c 20 70 6f  69 6e 74 20 74 6f 20 74  | will point to t|
00000600  68 65 20 63 6f 6d 6d 61  6e 64 20 77 69 74 68 20  |he command with |
00000610  74 68 65 20 6f 66 66 73  65 74 20 69 6e 20 59 0d  |the offset in Y.|
00000620  70 6f 69 6e 74 69 6e 67  20 74 6f 20 74 68 65 20  |pointing to the |
00000630  73 65 63 6f 6e 64 20 52  20 6f 66 20 43 55 52 53  |second R of CURS|
00000640  4f 52 2e 20 41 66 74 65  72 20 63 61 6c 6c 69 6e  |OR. After callin|
00000650  67 20 47 73 69 6e 69 74  20 74 68 65 20 6f 66 66  |g Gsinit the off|
00000660  73 65 74 20 69 6e 0d 59  20 77 69 6c 6c 20 70 6f  |set in.Y will po|
00000670  69 6e 74 20 74 6f 20 74  68 65 20 4f 20 6f 66 20  |int to the O of |
00000680  4f 4e 2c 20 74 68 65 20  7a 65 72 6f 20 66 6c 61  |ON, the zero fla|
00000690  67 20 77 69 6c 6c 20 62  65 20 63 6c 65 61 72 2c  |g will be clear,|
000006a0  20 61 6e 64 20 74 68 65  0d 74 65 72 6d 69 6e 61  | and the.termina|
000006b0  74 69 6e 67 20 63 68 61  72 61 63 74 65 72 20 77  |ting character w|
000006c0  69 6c 6c 20 62 65 20 74  68 65 20 63 61 72 72 69  |ill be the carri|
000006d0  61 67 65 20 72 65 74 75  72 6e 20 61 66 74 65 72  |age return after|
000006e0  20 74 68 65 20 4e 20 6f  66 20 4f 4e 2e 0d 49 66  | the N of ON..If|
000006f0  20 4f 4e 20 69 73 20 65  6e 63 6c 6f 73 65 64 20  | ON is enclosed |
00000700  62 79 20 71 75 6f 74 61  74 69 6f 6e 20 6d 61 72  |by quotation mar|
00000710  6b 73 20 74 68 65 20 6f  66 66 73 65 74 20 69 6e  |ks the offset in|
00000720  20 59 20 77 69 6c 6c 20  73 74 69 6c 6c 20 70 6f  | Y will still po|
00000730  69 6e 74 0d 74 6f 20 74  68 65 20 4f 20 6f 66 20  |int.to the O of |
00000740  4f 4e 20 61 6e 64 20 74  68 65 20 7a 65 72 6f 20  |ON and the zero |
00000750  66 6c 61 67 20 77 69 6c  6c 20 62 65 20 63 6c 65  |flag will be cle|
00000760  61 72 2c 20 62 75 74 20  74 68 65 20 74 65 72 6d  |ar, but the term|
00000770  69 6e 61 74 69 6e 67 0d  63 68 61 72 61 63 74 65  |inating.characte|
00000780  72 20 77 69 6c 6c 20 62  65 20 74 68 65 20 73 65  |r will be the se|
00000790  63 6f 6e 64 20 71 75 6f  74 61 74 69 6f 6e 20 6d  |cond quotation m|
000007a0  61 72 6b 2e 20 49 66 20  61 6e 20 61 72 67 75 6d  |ark. If an argum|
000007b0  65 6e 74 20 69 73 20 6e  6f 74 0d 74 79 70 65 64  |ent is not.typed|
000007c0  20 6f 72 20 69 66 20 2a  43 55 52 53 4f 52 20 22  | or if *CURSOR "|
000007d0  22 20 69 73 20 74 79 70  65 64 20 74 68 65 20 7a  |" is typed the z|
000007e0  65 72 6f 20 66 6c 61 67  20 77 69 6c 6c 20 62 65  |ero flag will be|
000007f0  20 73 65 74 20 6f 6e 20  72 65 74 75 72 6e 0d 66  | set on return.f|
00000800  72 6f 6d 20 47 73 69 6e  69 74 2e 20 46 69 67 75  |rom Gsinit. Figu|
00000810  72 65 20 35 2e 31 20 73  68 6f 77 73 20 74 68 65  |re 5.1 shows the|
00000820  20 6f 66 66 73 65 74 20  69 6e 20 74 68 65 20 59  | offset in the Y|
00000830  20 72 65 67 69 73 74 65  72 20 70 6f 69 6e 74 69  | register pointi|
00000840  6e 67 20 74 6f 0d 74 68  65 20 65 6e 64 20 6f 66  |ng to.the end of|
00000850  20 74 68 65 20 63 6f 6d  6d 61 6e 64 20 62 65 66  | the command bef|
00000860  6f 72 65 20 63 61 6c 6c  69 6e 67 20 47 73 69 6e  |ore calling Gsin|
00000870  69 74 20 61 6e 64 20 70  6f 69 6e 74 69 6e 67 20  |it and pointing |
00000880  74 6f 20 74 68 65 0d 62  65 67 69 6e 6e 69 6e 67  |to the.beginning|
00000890  20 6f 66 20 74 68 65 20  61 72 67 75 6d 65 6e 74  | of the argument|
000008a0  20 61 66 74 65 72 20 63  61 6c 6c 69 6e 67 20 47  | after calling G|
000008b0  73 69 6e 69 74 2e 0d 0d  0d 0d 0d 20 20 20 20 20  |sinit......     |
000008c0  20 20 2b 2d 20 59 20 62  65 66 6f 72 65 20 47 73  |  +- Y before Gs|
000008d0  69 6e 69 74 20 2d 2b 0d  20 20 20 20 20 20 20 21  |init -+.       !|
000008e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000008f0  20 20 20 21 0d 20 20 20  20 20 20 20 76 20 20 20  |   !.       v   |
00000900  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000910  76 0d 3e 2a 43 55 52 53  4f 52 20 4f 4e 20 20 20  |v.>*CURSOR ON   |
00000920  20 20 20 20 20 20 3e 2a  43 55 52 53 4f 52 20 22  |      >*CURSOR "|
00000930  4f 4e 22 0d 20 20 20 20  20 20 20 20 20 5e 20 20  |ON".         ^  |
00000940  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000950  20 20 5e 0d 20 20 20 20  20 20 20 20 20 21 20 20  |  ^.         !  |
00000960  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000970  20 20 21 0d 20 20 20 20  20 20 20 20 20 2b 2d 2d  |  !.         +--|
00000980  20 59 20 61 66 74 65 72  20 47 73 69 6e 69 74 20  | Y after Gsinit |
00000990  2d 2d 2b 0d 0d 46 69 67  75 72 65 20 35 2e 31 20  |--+..Figure 5.1 |
000009a0  54 68 65 20 6f 66 66 73  65 74 20 69 6e 20 59 20  |The offset in Y |
000009b0  62 65 66 6f 72 65 20 61  6e 64 20 61 66 74 65 72  |before and after|
000009c0  20 63 61 6c 6c 69 6e 67  20 47 73 69 6e 69 74 2e  | calling Gsinit.|
000009d0  0d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000009e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000a00  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0d 0d 0d 0d  |------------....|
00000a10  0d 20 20 47 73 72 65 61  64 20 69 73 20 75 73 65  |.  Gsread is use|
00000a20  64 20 74 6f 20 72 65 61  64 20 65 61 63 68 20 62  |d to read each b|
00000a30  79 74 65 20 6f 66 20 74  68 65 20 61 72 67 75 6d  |yte of the argum|
00000a40  65 6e 74 2e 20 54 68 69  73 20 72 6f 75 74 69 6e  |ent. This routin|
00000a50  65 0d 73 68 6f 75 6c 64  20 6f 6e 6c 79 20 62 65  |e.should only be|
00000a60  20 75 73 65 64 20 66 6f  6c 6c 6f 77 69 6e 67 20  | used following |
00000a70  61 20 47 73 69 6e 69 74  20 63 61 6c 6c 20 6f 72  |a Gsinit call or|
00000a80  20 61 20 70 72 65 76 69  6f 75 73 20 47 73 72 65  | a previous Gsre|
00000a90  61 64 2e 0d 46 6f 6c 6c  6f 77 69 6e 67 20 47 73  |ad..Following Gs|
00000aa0  69 6e 69 74 20 74 68 65  20 74 65 78 74 20 70 6f  |init the text po|
00000ab0  69 6e 74 65 72 73 20 61  6e 64 20 59 20 72 65 67  |inters and Y reg|
00000ac0  69 73 74 65 72 20 77 69  6c 6c 20 70 6f 69 6e 74  |ister will point|
00000ad0  20 74 6f 20 74 68 65 0d  66 69 72 73 74 20 62 79  | to the.first by|
00000ae0  74 65 20 6f 66 20 74 68  65 20 61 72 67 75 6d 65  |te of the argume|
00000af0  6e 74 2e 20 41 66 74 65  72 20 63 61 6c 6c 69 6e  |nt. After callin|
00000b00  67 20 47 73 72 65 61 64  20 74 68 65 20 61 63 63  |g Gsread the acc|
00000b10  75 6d 75 6c 61 74 6f 72  0d 63 6f 6e 74 61 69 6e  |umulator.contain|
00000b20  73 20 74 68 65 20 63 68  61 72 61 63 74 65 72 20  |s the character |
00000b30  72 65 61 64 20 66 72 6f  6d 20 74 68 65 20 61 72  |read from the ar|
00000b40  67 75 6d 65 6e 74 2c 20  59 20 69 73 20 69 6e 63  |gument, Y is inc|
00000b50  72 65 6d 65 6e 74 65 64  20 74 6f 0d 70 6f 69 6e  |remented to.poin|
00000b60  74 20 74 6f 20 74 68 65  20 6e 65 78 74 20 63 68  |t to the next ch|
00000b70  61 72 61 63 74 65 72 2c  20 58 20 69 73 20 70 72  |aracter, X is pr|
00000b80  65 73 65 72 76 65 64 20  61 6e 64 20 74 68 65 20  |eserved and the |
00000b90  63 61 72 72 79 20 66 6c  61 67 20 69 73 20 73 65  |carry flag is se|
00000ba0  74 0d 69 66 20 74 68 65  20 74 65 72 6d 69 6e 61  |t.if the termina|
00000bb0  74 69 6e 67 20 63 68 61  72 61 63 74 65 72 20 68  |ting character h|
00000bc0  61 73 20 62 65 65 6e 20  72 65 61 64 2e 0d 0d 20  |as been read... |
00000bd0  20 54 68 65 20 65 66 66  65 63 74 20 6f 66 20 63  | The effect of c|
00000be0  61 6c 6c 69 6e 67 20 47  73 72 65 61 64 20 69 73  |alling Gsread is|
00000bf0  20 73 69 6d 69 6c 61 72  20 74 6f 2c 20 62 75 74  | similar to, but|
00000c00  20 6e 6f 74 20 74 68 65  20 73 61 6d 65 20 61 73  | not the same as|
00000c10  3a 0d 0d 20 20 4c 44 41  20 28 26 46 32 29 2c 59  |:..  LDA (&F2),Y|
00000c20  0d 20 20 49 4e 59 0d 0d  20 20 54 68 65 20 64 69  |.  INY..  The di|
00000c30  66 66 65 72 65 6e 63 65  20 65 78 69 73 74 73 20  |fference exists |
00000c40  62 65 63 61 75 73 65 20  47 73 72 65 61 64 20 74  |because Gsread t|
00000c50  65 73 74 73 20 74 68 65  20 63 6f 6e 74 65 6e 74  |ests the content|
00000c60  20 6f 66 20 41 20 74 6f  20 73 65 65 0d 69 66 20  | of A to see.if |
00000c70  74 68 65 20 74 65 72 6d  69 6e 61 74 69 6e 67 20  |the terminating |
00000c80  63 68 61 72 61 63 74 65  72 2c 20 61 6e 64 20 68  |character, and h|
00000c90  65 6e 63 65 20 74 68 65  20 65 6e 64 20 6f 66 20  |ence the end of |
00000ca0  74 68 65 20 61 72 67 75  6d 65 6e 74 2c 20 68 61  |the argument, ha|
00000cb0  73 0d 62 65 65 6e 20 72  65 61 64 2e 20 54 68 65  |s.been read. The|
00000cc0  20 74 65 72 6d 69 6e 61  74 69 6e 67 20 63 68 61  | terminating cha|
00000cd0  72 61 63 74 65 72 20 63  61 6e 20 62 65 20 65 69  |racter can be ei|
00000ce0  74 68 65 72 20 61 20 73  65 63 6f 6e 64 20 71 75  |ther a second qu|
00000cf0  6f 74 61 74 69 6f 6e 0d  6d 61 72 6b 2c 20 61 20  |otation.mark, a |
00000d00  73 70 61 63 65 20 6f 72  20 61 20 63 61 72 72 69  |space or a carri|
00000d10  61 67 65 20 72 65 74 75  72 6e 20 61 73 20 64 65  |age return as de|
00000d20  66 69 6e 65 64 20 62 79  20 47 73 69 6e 69 74 2e  |fined by Gsinit.|
00000d30  20 55 73 69 6e 67 20 47  73 69 6e 69 74 0d 74 6f  | Using Gsinit.to|
00000d40  20 69 6e 69 74 69 61 6c  69 73 65 20 61 6e 20 61  | initialise an a|
00000d50  72 67 75 6d 65 6e 74 20  61 6e 64 20 47 73 72 65  |rgument and Gsre|
00000d60  61 64 20 74 6f 20 72 65  61 64 20 69 74 20 69 73  |ad to read it is|
00000d70  20 6d 6f 72 65 20 76 65  72 73 61 74 69 6c 65 20  | more versatile |
00000d80  74 68 61 6e 0d 73 69 6d  70 6c 79 20 72 65 61 64  |than.simply read|
00000d90  69 6e 67 20 74 68 65 20  61 72 67 75 6d 65 6e 74  |ing the argument|
00000da0  20 75 73 69 6e 67 20 70  6f 73 74 2d 69 6e 64 65  | using post-inde|
00000db0  78 65 64 20 69 6e 64 69  72 65 63 74 20 61 64 64  |xed indirect add|
00000dc0  72 65 73 73 69 6e 67 0d  77 69 74 68 20 74 68 65  |ressing.with the|
00000dd0  20 74 65 78 74 20 70 6f  69 6e 74 65 72 73 2e 20  | text pointers. |
00000de0  54 68 65 20 64 69 66 66  65 72 65 6e 63 65 20 6d  |The difference m|
00000df0  61 79 20 73 65 65 6d 20  69 6e 73 69 67 6e 69 66  |ay seem insignif|
00000e00  69 63 61 6e 74 20 77 69  74 68 20 74 68 65 0d 73  |icant with the.s|
00000e10  69 6d 70 6c 65 20 65 78  61 6d 70 6c 65 20 75 73  |imple example us|
00000e20  65 64 20 61 62 6f 76 65  20 62 75 74 20 69 74 20  |ed above but it |
00000e30  69 73 20 75 73 65 66 75  6c 20 69 66 20 74 68 65  |is useful if the|
00000e40  20 61 72 67 75 6d 65 6e  74 20 69 73 20 61 20 6e  | argument is a n|
00000e50  75 6d 62 65 72 0d 77 68  65 6e 20 74 68 65 20 70  |umber.when the p|
00000e60  6c 61 63 65 20 76 61 6c  75 65 20 6f 66 20 61 20  |lace value of a |
00000e70  70 61 72 74 69 63 75 6c  61 72 20 63 68 61 72 61  |particular chara|
00000e80  63 74 65 72 20 64 65 70  65 6e 64 73 20 6f 6e 20  |cter depends on |
00000e90  69 74 73 0d 64 69 73 70  6c 61 63 65 6d 65 6e 74  |its.displacement|
00000ea0  20 66 72 6f 6d 20 74 68  65 20 74 65 72 6d 69 6e  | from the termin|
00000eb0  61 74 69 6e 67 20 63 68  61 72 61 63 74 65 72 2e  |ating character.|
00000ec0  20 52 65 61 64 69 6e 67  20 6e 75 6d 65 72 69 63  | Reading numeric|
00000ed0  61 6c 0d 61 72 67 75 6d  65 6e 74 73 20 77 69 6c  |al.arguments wil|
00000ee0  6c 20 62 65 20 63 6f 76  65 72 65 64 20 69 6e 20  |l be covered in |
00000ef0  6d 6f 64 75 6c 65 20 31  31 2e 0d 0d 20 20 42 65  |module 11...  Be|
00000f00  63 61 75 73 65 20 74 68  65 20 65 66 66 65 63 74  |cause the effect|
00000f10  20 6f 66 20 75 73 69 6e  67 20 47 73 72 65 61 64  | of using Gsread|
00000f20  20 69 73 20 76 65 72 79  20 73 69 6d 69 6c 61 72  | is very similar|
00000f30  20 74 6f 20 72 65 61 64  69 6e 67 20 61 0d 73 74  | to reading a.st|
00000f40  72 69 6e 67 20 75 73 69  6e 67 20 70 6f 73 74 2d  |ring using post-|
00000f50  69 6e 64 65 78 65 64 20  69 6e 64 69 72 65 63 74  |indexed indirect|
00000f60  20 61 64 64 72 65 73 73  69 6e 67 20 77 69 74 68  | addressing with|
00000f70  20 74 68 65 20 74 65 78  74 20 70 6f 69 6e 74 65  | the text pointe|
00000f80  72 73 0d 79 6f 75 20 6d  61 79 20 62 65 20 74 65  |rs.you may be te|
00000f90  6d 70 74 65 64 20 74 6f  20 75 73 65 20 47 73 72  |mpted to use Gsr|
00000fa0  65 61 64 20 69 6e 20 74  68 65 20 69 6e 74 65 72  |ead in the inter|
00000fb0  70 72 65 74 65 72 20 74  6f 20 72 65 61 64 20 74  |preter to read t|
00000fc0  68 65 0d 75 6e 72 65 63  6f 67 6e 69 73 65 64 20  |he.unrecognised |
00000fd0  63 6f 6d 6d 61 6e 64 2e  20 49 66 20 79 6f 75 20  |command. If you |
00000fe0  64 6f 20 79 6f 75 20 77  69 6c 6c 20 66 69 6e 64  |do you will find|
00000ff0  20 74 68 61 74 20 6d 6f  73 74 20 6f 66 20 74 68  | that most of th|
00001000  65 20 74 69 6d 65 20 69  74 0d 77 69 6c 6c 20 77  |e time it.will w|
00001010  6f 72 6b 20 62 75 74 2c  20 73 6f 6f 6e 65 72 20  |ork but, sooner |
00001020  6f 72 20 6c 61 74 65 72  2c 20 79 6f 75 20 77 69  |or later, you wi|
00001030  6c 6c 20 73 74 61 72 74  20 67 65 74 74 69 6e 67  |ll start getting|
00001040  20 6d 79 73 74 65 72 69  6f 75 73 20 22 62 61 64  | mysterious "bad|
00001050  0d 73 74 72 69 6e 67 22  20 65 72 72 6f 72 20 6d  |.string" error m|
00001060  65 73 73 61 67 65 73 2e  20 44 6f 6e 27 74 20 62  |essages. Don't b|
00001070  65 20 74 65 6d 70 74 65  64 20 69 6e 74 6f 20 77  |e tempted into w|
00001080  61 73 74 69 6e 67 20 79  6f 75 72 20 74 69 6d 65  |asting your time|
00001090  20 75 73 69 6e 67 0d 47  73 72 65 61 64 20 69 6e  | using.Gsread in|
000010a0  20 74 68 65 20 69 6e 74  65 72 70 72 65 74 65 72  | the interpreter|
000010b0  2e 20 53 74 69 63 6b 20  77 69 74 68 20 74 68 65  |. Stick with the|
000010c0  20 6d 65 74 68 6f 64 20  64 65 6d 6f 6e 73 74 72  | method demonstr|
000010d0  61 74 65 64 20 69 6e 0d  4d 6f 64 75 6c 65 20 33  |ated in.Module 3|
000010e0  2e 0d 0d 20 20 46 69 67  75 72 65 20 35 2e 32 20  |...  Figure 5.2 |
000010f0  73 68 6f 77 73 20 68 6f  77 20 74 68 65 20 69 6e  |shows how the in|
00001100  74 65 72 70 72 65 74 65  72 20 75 73 65 64 20 69  |terpreter used i|
00001110  6e 20 74 68 65 20 6c 61  73 74 20 74 77 6f 20 6d  |n the last two m|
00001120  6f 64 75 6c 65 73 0d 63  61 6e 20 62 65 20 6d 6f  |odules.can be mo|
00001130  64 69 66 69 65 64 20 74  6f 20 72 65 61 64 20 61  |dified to read a|
00001140  6e 20 61 72 67 75 6d 65  6e 74 2e 0d 0d 0d 0d 0d  |n argument......|
00001150  0d 2e 66 6f 75 6e 64 0d  20 20 20 20 20 20 20 20  |..found.        |
00001160  20 53 45 43 20 20 20 20  20 20 20 20 20 20 20 5c  | SEC           \|
00001170  20 74 65 72 6d 69 6e 61  74 65 20 77 69 74 68 20  | terminate with |
00001180  52 65 74 75 72 6e 20 6f  72 20 22 0d 20 20 20 20  |Return or ".    |
00001190  20 20 20 20 20 4a 53 52  20 26 46 46 43 32 20 20  |     JSR &FFC2  |
000011a0  20 20 20 5c 20 69 6e 69  74 69 61 6c 69 73 65 20  |   \ initialise |
000011b0  61 72 67 75 6d 65 6e 74  20 77 69 74 68 20 47 73  |argument with Gs|
000011c0  69 6e 69 74 0d 20 20 20  20 20 20 20 20 20 42 45  |init.         BE|
000011d0  51 20 65 78 69 74 20 20  20 20 20 20 5c 20 62 72  |Q exit      \ br|
000011e0  61 6e 63 68 20 69 66 20  6e 75 6c 6c 20 61 72 67  |anch if null arg|
000011f0  75 6d 65 6e 74 0d 20 20  20 20 20 20 20 20 20 4a  |ument.         J|
00001200  53 52 20 26 46 46 43 35  20 20 20 20 20 5c 20 72  |SR &FFC5     \ r|
00001210  65 61 64 20 66 69 72 73  74 20 63 68 61 72 61 63  |ead first charac|
00001220  74 65 72 20 77 69 74 68  20 47 73 72 65 61 64 0d  |ter with Gsread.|
00001230  20 20 20 20 20 20 20 20  20 42 43 53 20 65 78 69  |         BCS exi|
00001240  74 20 20 20 20 20 20 5c  20 62 72 61 6e 63 68 20  |t      \ branch |
00001250  69 66 20 65 6e 64 20 6f  66 20 61 72 67 75 6d 65  |if end of argume|
00001260  6e 74 0d 20 20 20 20 20  20 20 20 20 41 4e 44 20  |nt.         AND |
00001270  23 26 44 46 20 20 20 20  20 20 5c 20 66 6f 72 63  |#&DF      \ forc|
00001280  65 20 75 70 70 65 72 20  63 61 73 65 0d 20 20 20  |e upper case.   |
00001290  20 20 20 20 20 20 20 2e  0d 20 20 20 20 20 20 20  |       ..       |
000012a0  20 20 20 2e 0d 20 20 20  20 20 20 20 20 20 20 2e  |   ..          .|
000012b0  0d 2e 65 78 69 74 0d 20  20 20 20 20 20 20 20 20  |..exit.         |
000012c0  50 4c 41 20 20 20 20 20  20 20 20 20 20 20 5c 20  |PLA           \ |
000012d0  64 69 73 63 61 72 64 20  59 0d 20 20 20 20 20 20  |discard Y.      |
000012e0  20 20 20 50 4c 41 20 20  20 20 20 20 20 20 20 20  |   PLA          |
000012f0  20 5c 20 64 69 73 63 61  72 64 20 58 0d 20 20 20  | \ discard X.   |
00001300  20 20 20 20 20 20 50 4c  41 20 20 20 20 20 20 20  |      PLA       |
00001310  20 20 20 20 5c 20 64 69  73 63 61 72 64 20 41 0d  |    \ discard A.|
00001320  20 20 20 20 20 20 20 20  20 4c 44 41 20 23 30 20  |         LDA #0 |
00001330  20 20 20 20 20 20 20 5c  20 73 65 72 76 69 63 65  |       \ service|
00001340  20 63 61 6c 6c 20 72 65  63 6f 67 6e 69 73 65 64  | call recognised|
00001350  0d 20 20 20 20 20 20 20  20 20 52 54 53 20 20 20  |.         RTS   |
00001360  20 20 20 20 20 20 20 20  5c 20 72 65 74 75 72 6e  |        \ return|
00001370  20 74 6f 20 4d 4f 53 0d  0d 46 69 67 75 72 65 20  | to MOS..Figure |
00001380  35 2e 32 20 55 73 69 6e  67 20 47 73 69 6e 69 74  |5.2 Using Gsinit|
00001390  20 61 6e 64 20 47 73 72  65 61 64 20 74 6f 20 72  | and Gsread to r|
000013a0  65 61 64 20 61 6e 20 61  72 67 75 6d 65 6e 74 2e  |ead an argument.|
000013b0  0d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000013c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000013e0  2d 2d 2d 2d 2d 2d 2d 2d  0d 0d 0d 0d 0d 20 20 54  |--------.....  T|
000013f0  68 65 20 63 61 72 72 79  20 66 6c 61 67 20 69 73  |he carry flag is|
00001400  20 73 65 74 20 62 65 66  6f 72 65 20 63 61 6c 6c  | set before call|
00001410  69 6e 67 20 47 73 69 6e  69 74 2e 20 54 68 65 20  |ing Gsinit. The |
00001420  74 65 72 6d 69 6e 61 74  69 6e 67 0d 63 68 61 72  |terminating.char|
00001430  61 63 74 65 72 20 6f 66  20 74 68 65 20 61 72 67  |acter of the arg|
00001440  75 6d 65 6e 74 20 77 69  6c 6c 20 62 65 20 61 20  |ument will be a |
00001450  63 61 72 72 69 61 67 65  20 72 65 74 75 72 6e 20  |carriage return |
00001460  6f 72 20 61 20 73 65 63  6f 6e 64 0d 71 75 6f 74  |or a second.quot|
00001470  61 74 69 6f 6e 20 6d 61  72 6b 2e 20 41 66 74 65  |ation mark. Afte|
00001480  72 20 73 65 74 74 69 6e  67 20 74 68 65 20 63 61  |r setting the ca|
00001490  72 72 79 20 66 6c 61 67  20 47 73 69 6e 69 74 20  |rry flag Gsinit |
000014a0  69 73 20 63 61 6c 6c 65  64 20 74 6f 0d 69 6e 69  |is called to.ini|
000014b0  74 69 61 6c 69 73 65 20  74 68 65 20 61 72 67 75  |tialise the argu|
000014c0  6d 65 6e 74 2e 20 49 66  20 74 68 65 20 61 72 67  |ment. If the arg|
000014d0  75 6d 65 6e 74 20 69 73  20 6e 75 6c 6c 20 47 73  |ument is null Gs|
000014e0  69 6e 69 74 20 72 65 74  75 72 6e 73 20 77 69 74  |init returns wit|
000014f0  68 0d 74 68 65 20 7a 65  72 6f 20 66 6c 61 67 20  |h.the zero flag |
00001500  73 65 74 2e 20 54 68 69  73 20 63 61 6e 20 62 65  |set. This can be|
00001510  20 74 65 73 74 65 64 20  61 6e 64 20 62 72 61 6e  | tested and bran|
00001520  63 68 20 74 6f 20 65 78  69 74 20 69 66 20 74 68  |ch to exit if th|
00001530  65 72 65 20 69 73 0d 6e  6f 74 68 69 6e 67 20 74  |ere is.nothing t|
00001540  6f 20 72 65 61 64 2e 20  49 66 20 74 68 65 20 7a  |o read. If the z|
00001550  65 72 6f 20 66 6c 61 67  20 69 73 20 63 6c 65 61  |ero flag is clea|
00001560  72 20 74 68 65 72 65 20  69 73 20 61 6e 20 61 72  |r there is an ar|
00001570  67 75 6d 65 6e 74 20 74  6f 20 62 65 0d 72 65 61  |gument to be.rea|
00001580  64 20 62 79 20 63 61 6c  6c 69 6e 67 20 47 73 72  |d by calling Gsr|
00001590  65 61 64 20 66 6f 72 20  65 61 63 68 20 63 68 61  |ead for each cha|
000015a0  72 61 63 74 65 72 2e 20  47 73 72 65 61 64 20 77  |racter. Gsread w|
000015b0  69 6c 6c 20 72 65 74 75  72 6e 20 77 69 74 68 20  |ill return with |
000015c0  74 68 65 0d 63 61 72 72  79 20 66 6c 61 67 20 73  |the.carry flag s|
000015d0  65 74 20 77 68 65 6e 20  74 68 65 20 74 65 72 6d  |et when the term|
000015e0  69 6e 61 74 69 6e 67 20  63 68 61 72 61 63 74 65  |inating characte|
000015f0  72 20 69 73 20 72 65 61  64 20 61 6e 64 20 61 6e  |r is read and an|
00001600  0d 61 70 70 72 6f 70 72  69 61 74 65 20 62 72 61  |.appropriate bra|
00001610  6e 63 68 20 63 61 6e 20  62 65 20 6d 61 64 65 20  |nch can be made |
00001620  61 66 74 65 72 20 74 65  73 74 69 6e 67 20 74 68  |after testing th|
00001630  65 20 63 61 72 72 79 20  66 6c 61 67 2e 0d 0d 20  |e carry flag... |
00001640  20 54 68 69 73 20 6d 65  74 68 6f 64 20 6f 66 20  | This method of |
00001650  72 65 61 64 69 6e 67 20  61 6e 20 61 72 67 75 6d  |reading an argum|
00001660  65 6e 74 20 68 61 73 20  62 65 65 6e 20 75 73 65  |ent has been use|
00001670  64 20 69 6e 20 74 68 65  20 70 72 6f 67 72 61 6e  |d in the progran|
00001680  0d 43 55 52 53 4f 52 2e  20 57 68 65 6e 20 74 68  |.CURSOR. When th|
00001690  65 20 69 6e 74 65 72 70  72 65 74 65 72 20 28 6c  |e interpreter (l|
000016a0  69 6e 65 73 20 32 38 30  2d 35 34 30 29 20 72 65  |ines 280-540) re|
000016b0  63 6f 67 6e 69 73 65 73  20 74 68 65 20 63 6f 6d  |cognises the com|
000016c0  6d 61 6e 64 0d 2a 43 55  52 53 4f 52 20 69 74 20  |mand.*CURSOR it |
000016d0  70 61 73 73 65 73 20 63  6f 6e 74 72 6f 6c 20 74  |passes control t|
000016e0  6f 20 74 68 65 20 6c 61  62 65 6c 20 22 2e 66 6f  |o the label ".fo|
000016f0  75 6e 64 22 20 28 6c 69  6e 65 20 35 35 30 29 2e  |und" (line 550).|
00001700  20 54 68 65 0d 61 72 67  75 6d 65 6e 74 20 69 73  | The.argument is|
00001710  20 69 6e 69 74 69 61 6c  69 73 65 64 20 28 6c 69  | initialised (li|
00001720  6e 65 73 20 35 36 30 2d  35 37 30 29 20 61 6e 64  |nes 560-570) and|
00001730  20 74 68 65 20 61 72 67  75 6d 65 6e 74 20 69 73  | the argument is|
00001740  20 74 65 73 74 65 64 0d  28 6c 69 6e 65 20 35 38  | tested.(line 58|
00001750  30 29 2e 20 49 66 20 61  20 6e 75 6c 6c 20 61 72  |0). If a null ar|
00001760  67 75 6d 65 6e 74 20 69  73 20 64 65 74 65 63 74  |gument is detect|
00001770  65 64 20 74 68 65 20 70  72 6f 67 72 61 6d 20 72  |ed the program r|
00001780  65 74 75 72 6e 73 20 63  6f 6e 74 72 6f 6c 0d 74  |eturns control.t|
00001790  6f 20 74 68 65 20 4d 4f  53 20 77 69 74 68 20 41  |o the MOS with A|
000017a0  3d 30 20 28 6c 69 6e 65  73 20 38 36 30 2d 39 31  |=0 (lines 860-91|
000017b0  30 29 2e 20 49 66 20 61  6e 20 61 72 67 75 6d 65  |0). If an argume|
000017c0  6e 74 20 69 73 20 66 6f  75 6e 64 20 74 68 65 0d  |nt is found the.|
000017d0  70 72 6f 67 72 61 6d 20  65 78 70 65 63 74 73 20  |program expects |
000017e0  74 6f 20 72 65 61 64 20  65 69 74 68 65 72 20 4f  |to read either O|
000017f0  4e 20 6f 72 20 4f 46 46  2e 20 54 6f 20 74 65 73  |N or OFF. To tes|
00001800  74 20 66 6f 72 20 4f 4e  20 6f 72 20 4f 46 46 20  |t for ON or OFF |
00001810  74 68 65 0d 66 69 72 73  74 20 63 68 61 72 61 63  |the.first charac|
00001820  74 65 72 20 63 61 6e 20  62 65 20 73 6b 69 70 70  |ter can be skipp|
00001830  65 64 20 73 69 6e 63 65  20 69 74 20 73 68 6f 75  |ed since it shou|
00001840  6c 64 20 62 65 20 61 6e  20 22 4f 22 20 28 6c 69  |ld be an "O" (li|
00001850  6e 65 20 35 39 30 29 2e  0d 54 68 65 20 6e 65 78  |ne 590)..The nex|
00001860  74 20 63 68 61 72 61 63  74 65 72 20 69 73 20 72  |t character is r|
00001870  65 61 64 20 75 73 69 6e  67 20 47 73 72 65 61 64  |ead using Gsread|
00001880  20 28 6c 69 6e 65 20 36  30 30 29 20 61 6e 64 20  | (line 600) and |
00001890  74 65 73 74 65 64 20 66  6f 72 20 61 0d 74 65 72  |tested for a.ter|
000018a0  6d 69 6e 61 74 69 6e 67  20 63 68 61 72 61 63 74  |minating charact|
000018b0  65 72 20 28 6c 69 6e 65  20 36 31 30 29 20 61 6e  |er (line 610) an|
000018c0  64 20 65 69 74 68 65 72  20 22 46 22 20 28 6c 69  |d either "F" (li|
000018d0  6e 65 20 36 33 30 29 20  6f 72 20 22 4e 22 0d 28  |ne 630) or "N".(|
000018e0  6c 69 6e 65 20 36 35 30  29 2e 20 54 68 65 72 65  |line 650). There|
000018f0  20 69 73 20 6e 6f 20 6e  65 65 64 20 74 6f 20 72  | is no need to r|
00001900  65 61 64 20 61 6e 64 20  74 65 73 74 20 66 6f 72  |ead and test for|
00001910  20 74 68 65 20 73 65 63  6f 6e 64 20 46 20 6f 66  | the second F of|
00001920  20 4f 46 46 2e 0d 49 66  20 74 68 65 20 73 65 63  | OFF..If the sec|
00001930  6f 6e 64 20 63 68 61 72  61 63 74 65 72 20 6f 66  |ond character of|
00001940  20 74 68 65 20 61 72 67  75 6d 65 6e 74 20 69 73  | the argument is|
00001950  20 22 46 22 20 74 68 65  20 63 75 72 73 6f 72 20  | "F" the cursor |
00001960  69 73 20 73 77 69 74 63  68 65 64 0d 6f 66 66 20  |is switched.off |
00001970  28 6c 69 6e 65 73 20 36  39 30 2d 38 35 30 29 2c  |(lines 690-850),|
00001980  20 69 66 20 69 74 20 69  73 20 22 4e 22 20 74 68  | if it is "N" th|
00001990  65 20 63 75 72 73 6f 72  20 69 73 20 73 77 69 74  |e cursor is swit|
000019a0  63 68 65 64 20 6f 6e 20  28 6c 69 6e 65 73 0d 36  |ched on (lines.6|
000019b0  37 30 2d 38 35 30 29 2e  0d 0d 20 20 57 68 65 6e  |70-850)...  When|
000019c0  20 79 6f 75 20 6c 6f 61  64 20 74 68 65 20 6f 62  | you load the ob|
000019d0  6a 65 63 74 20 63 6f 64  65 20 67 65 6e 65 72 61  |ject code genera|
000019e0  74 65 64 20 62 79 20 43  55 52 53 4f 52 20 69 6e  |ted by CURSOR in|
000019f0  74 6f 20 53 57 52 20 74  6f 20 73 65 65 0d 68 6f  |to SWR to see.ho|
00001a00  77 20 69 74 20 77 6f 72  6b 73 20 69 74 20 69 73  |w it works it is|
00001a10  20 70 6f 73 73 69 62 6c  65 20 74 6f 20 64 65 63  | possible to dec|
00001a20  65 69 76 65 20 79 6f 75  72 73 65 6c 66 20 69 6e  |eive yourself in|
00001a30  74 6f 20 62 65 6c 69 65  76 69 6e 67 20 74 68 61  |to believing tha|
00001a40  74 0d 74 68 65 72 65 20  69 73 20 73 6f 6d 65 74  |t.there is somet|
00001a50  68 69 6e 67 20 77 72 6f  6e 67 20 77 69 74 68 20  |hing wrong with |
00001a60  69 74 2e 20 49 66 20 79  6f 75 20 74 79 70 65 20  |it. If you type |
00001a70  2a 43 55 52 53 4f 52 20  4f 46 46 20 61 6e 64 20  |*CURSOR OFF and |
00001a80  70 72 65 73 73 0d 52 65  74 75 72 6e 20 74 68 65  |press.Return the|
00001a90  20 63 75 72 73 6f 72 20  77 69 6c 6c 20 67 6f 20  | cursor will go |
00001aa0  6f 66 66 20 61 73 20 65  78 70 65 63 74 65 64 2e  |off as expected.|
00001ab0  20 54 79 70 65 20 2a 43  55 52 53 4f 52 20 4f 4e  | Type *CURSOR ON|
00001ac0  20 61 6e 64 20 69 74 20  77 69 6c 6c 0d 63 6f 6d  | and it will.com|
00001ad0  65 20 62 61 63 6b 20 6f  6e 2e 20 45 76 65 72 79  |e back on. Every|
00001ae0  74 68 69 6e 67 20 73 65  65 6d 73 20 4f 4b 2e 20  |thing seems OK. |
00001af0  54 79 70 65 20 2a 43 55  52 53 4f 52 20 4f 46 46  |Type *CURSOR OFF|
00001b00  20 61 6e 64 20 52 65 74  75 72 6e 20 61 6e 64 0d  | and Return and.|
00001b10  74 68 65 6e 20 74 79 70  65 20 2a 43 55 52 53 4f  |then type *CURSO|
00001b20  52 20 61 6e 64 20 52 65  74 75 72 6e 2e 20 54 68  |R and Return. Th|
00001b30  65 20 63 75 72 73 6f 72  20 73 74 61 79 73 20 6f  |e cursor stays o|
00001b40  66 66 20 62 65 63 61 75  73 65 20 79 6f 75 20 68  |ff because you h|
00001b50  61 76 65 0d 6e 6f 74 20  74 79 70 65 64 20 61 6e  |ave.not typed an|
00001b60  20 61 72 67 75 6d 65 6e  74 2e 20 45 76 65 72 79  | argument. Every|
00001b70  74 68 69 6e 67 20 69 73  20 73 74 69 6c 6c 20 4f  |thing is still O|
00001b80  4b 2e 20 4e 6f 77 20 75  73 65 20 74 68 65 20 63  |K. Now use the c|
00001b90  75 72 73 6f 72 20 6b 65  79 73 0d 74 6f 20 63 6f  |ursor keys.to co|
00001ba0  70 79 20 74 68 65 20 2a  43 55 52 53 4f 52 20 63  |py the *CURSOR c|
00001bb0  6f 6d 6d 61 6e 64 20 77  69 74 68 6f 75 74 20 61  |ommand without a|
00001bc0  6e 20 61 72 67 75 6d 65  6e 74 20 61 6e 64 20 70  |n argument and p|
00001bd0  72 65 73 73 20 52 65 74  75 72 6e 2e 20 54 68 65  |ress Return. The|
00001be0  0d 63 75 72 73 6f 72 20  63 6f 6d 65 73 20 62 61  |.cursor comes ba|
00001bf0  63 6b 20 6f 6e 20 77 68  65 6e 20 69 74 20 73 68  |ck on when it sh|
00001c00  6f 75 6c 64 20 68 61 76  65 20 73 74 61 79 65 64  |ould have stayed|
00001c10  20 6f 66 66 2e 20 54 68  69 73 20 77 69 6c 6c 20  | off. This will |
00001c20  68 61 70 70 65 6e 0d 62  65 63 61 75 73 65 20 79  |happen.because y|
00001c30  6f 75 20 77 69 6c 6c 20  72 65 2d 65 6e 61 62 6c  |ou will re-enabl|
00001c40  65 20 74 68 65 20 63 75  72 73 6f 72 20 77 69 74  |e the cursor wit|
00001c50  68 20 74 68 65 20 63 75  72 73 6f 72 20 6b 65 79  |h the cursor key|
00001c60  73 2e 20 54 68 65 72 65  20 69 73 0d 6e 6f 74 68  |s. There is.noth|
00001c70  69 6e 67 20 77 72 6f 6e  67 20 77 69 74 68 20 74  |ing wrong with t|
00001c80  68 65 20 61 72 67 75 6d  65 6e 74 20 72 65 61 64  |he argument read|
00001c90  69 6e 67 20 74 65 63 68  6e 69 71 75 65 20 64 65  |ing technique de|
00001ca0  6d 6f 6e 73 74 72 61 74  65 64 20 69 6e 20 74 68  |monstrated in th|
00001cb0  65 0d 70 72 6f 67 72 61  6d 2e 0d 0d 0d 0d 0d 0d  |e.program.......|
00001cc0  20 20 20 31 30 20 52 45  4d 3a 20 43 55 52 53 4f  |   10 REM: CURSO|
00001cd0  52 0d 20 20 20 32 30 20  4d 4f 44 45 37 0d 20 20  |R.   20 MODE7.  |
00001ce0  20 33 30 20 48 49 4d 45  4d 3d 26 33 43 30 30 0d  | 30 HIMEM=&3C00.|
00001cf0  20 20 20 34 30 20 44 49  4d 20 73 61 76 65 20 35  |   40 DIM save 5|
00001d00  30 0d 20 20 20 35 30 20  64 69 66 66 3d 26 38 30  |0.   50 diff=&80|
00001d10  30 30 2d 48 49 4d 45 4d  0d 20 20 20 36 30 20 63  |00-HIMEM.   60 c|
00001d20  6f 6d 76 65 63 3d 26 46  32 0d 20 20 20 37 30 20  |omvec=&F2.   70 |
00001d30  67 73 69 6e 69 74 3d 26  46 46 43 32 0d 20 20 20  |gsinit=&FFC2.   |
00001d40  38 30 20 67 73 72 65 61  64 3d 26 46 46 43 35 0d  |80 gsread=&FFC5.|
00001d50  20 20 20 39 30 20 6f 73  61 73 63 69 3d 26 46 46  |   90 osasci=&FF|
00001d60  45 33 0d 20 20 31 30 30  20 6f 73 63 6c 69 3d 26  |E3.  100 oscli=&|
00001d70  46 46 46 37 0d 20 20 31  31 30 20 46 4f 52 20 70  |FFF7.  110 FOR p|
00001d80  61 73 73 20 3d 20 30 20  54 4f 20 32 20 53 54 45  |ass = 0 TO 2 STE|
00001d90  50 20 32 0d 20 20 31 00  00 00 00 00 00 00 00 00  |P 2.  1.........|
00001da0  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
00002130  00 00 00 00 00 00 00 00  41 58 0d 20 20 35 33 30  |........AX.  530|
00002140  20 20 20 20 20 20 20 20  20 50 4c 41 0d 20 20 35  |         PLA.  5|
00002150  34 30 20 20 20 20 20 20  20 20 20 52 54 53 0d 20  |40         RTS. |
00002160  20 35 35 30 20 2e 66 6f  75 6e 64 0d 20 20 35 36  | 550 .found.  56|
00002170  30 20 20 20 20 20 20 20  20 20 53 45 43 20 20 20  |0         SEC   |
00002180  20 20 20 20 20 20 20 20  5c 20 54 65 72 6d 69 6e  |        \ Termin|
00002190  61 74 65 20 77 69 74 68  20 52 65 74 75 72 6e 20  |ate with Return |
000021a0  6f 72 20 22 0d 20 20 35  37 30 20 20 20 20 20 20  |or ".  570      |
000021b0  20 20 20 4a 53 52 20 67  73 69 6e 69 74 0d 20 20  |   JSR gsinit.  |
000021c0  35 38 30 20 20 20 20 20  20 20 20 20 42 45 51 20  |580         BEQ |
000021d0  65 78 69 74 20 20 20 20  20 20 5c 20 42 72 61 6e  |exit      \ Bran|
000021e0  63 68 20 69 66 20 6e 75  6c 6c 20 61 72 67 75 6d  |ch if null argum|
000021f0  65 6e 74 0d 20 20 35 39  30 20 20 20 20 20 20 20  |ent.  590       |
00002200  20 20 49 4e 59 20 20 20  20 20 20 20 20 20 20 20  |  INY           |
00002210  5c 20 46 69 72 73 74 20  63 68 61 72 61 63 74 65  |\ First characte|
00002220  72 20 6d 75 73 74 20 62  65 20 22 4f 22 0d 20 20  |r must be "O".  |
00002230  36 30 30 20 20 20 20 20  20 20 20 20 4a 53 52 20  |600         JSR |
00002240  67 73 72 65 61 64 20 20  20 20 5c 20 53 65 63 6f  |gsread    \ Seco|
00002250  6e 64 20 63 68 61 72 61  63 74 65 72 20 22 46 22  |nd character "F"|
00002260  20 6f 72 20 22 4e 22 0d  20 20 36 31 30 20 20 20  | or "N".  610   |
00002270  20 20 20 20 20 20 42 43  53 20 65 78 69 74 20 20  |      BCS exit  |
00002280  20 20 20 20 5c 20 42 72  61 6e 63 68 20 69 66 20  |    \ Branch if |
00002290  65 6e 64 20 6f 66 20 61  72 67 75 6d 65 6e 74 0d  |end of argument.|
000022a0  20 20 36 32 30 20 20 20  20 20 20 20 20 20 41 4e  |  620         AN|
000022b0  44 20 23 26 44 46 20 20  20 20 20 20 5c 20 55 70  |D #&DF      \ Up|
000022c0  70 65 72 20 63 61 73 65  0d 20 20 36 33 30 20 20  |per case.  630  |
000022d0  20 20 20 20 20 20 20 43  4d 50 20 23 41 53 43 28  |       CMP #ASC(|
000022e0  22 46 22 29 0d 20 20 36  34 30 20 20 20 20 20 20  |"F").  640      |
000022f0  20 20 20 42 45 51 20 63  75 72 73 6f 72 6f 66 66  |   BEQ cursoroff|
00002300  0d 20 20 36 35 30 20 20  20 20 20 20 20 20 20 43  |.  650         C|
00002310  4d 50 20 23 41 53 43 28  22 4e 22 29 0d 20 20 36  |MP #ASC("N").  6|
00002320  36 30 20 20 20 20 20 20  20 20 20 42 4e 45 20 65  |60         BNE e|
00002330  78 69 74 0d 20 20 36 37  30 20 20 20 20 20 20 20  |xit.  670       |
00002340  20 20 53 45 43 0d 20 20  36 38 30 20 20 20 20 20  |  SEC.  680     |
00002350  20 20 20 20 42 43 53 20  63 75 72 73 6f 72 0d 20  |    BCS cursor. |
00002360  20 36 39 30 20 2e 63 75  72 73 6f 72 6f 66 66 0d  | 690 .cursoroff.|
00002370  20 20 37 30 30 20 20 20  20 20 20 20 20 20 43 4c  |  700         CL|
00002380  43 0d 20 20 37 31 30 20  2e 63 75 72 73 6f 72 0d  |C.  710 .cursor.|
00002390  20 20 37 32 30 20 20 20  20 20 20 20 20 20 50 48  |  720         PH|
000023a0  50 0d 20 20 37 33 30 20  20 20 20 20 20 20 20 20  |P.  730         |
000023b0  4c 44 41 20 23 32 33 0d  20 20 37 34 30 20 20 20  |LDA #23.  740   |
000023c0  20 20 20 20 20 20 4a 53  52 20 6f 73 61 73 63 69  |      JSR osasci|
000023d0  0d 20 20 37 35 30 20 20  20 20 20 20 20 20 20 4c  |.  750         L|
000023e0  44 41 20 23 31 0d 20 20  37 36 30 20 20 20 20 20  |DA #1.  760     |
000023f0  20 20 20 20 4a 53 52 20  6f 73 61 73 63 69 0d 20  |    JSR osasci. |
00002400  20 37 37 30 20 20 20 20  20 20 20 20 20 50 4c 41  | 770         PLA|
00002410  0d 20 20 37 38 30 20 20  20 20 20 20 20 20 20 41  |.  780         A|
00002420  4e 44 20 23 31 0d 20 20  37 39 30 20 20 20 20 20  |ND #1.  790     |
00002430  20 20 20 20 4a 53 52 20  6f 73 61 73 63 69 0d 20  |    JSR osasci. |
00002440  20 38 30 30 20 20 20 20  20 20 20 20 20 4c 44 41  | 800         LDA|
00002450  20 23 30 0d 20 20 38 31  30 20 20 20 20 20 20 20  | #0.  810       |
00002460  20 20 4c 44 58 20 23 37  0d 20 20 38 32 30 20 2e  |  LDX #7.  820 .|
00002470  63 75 72 73 6f 72 6c 6f  6f 70 0d 20 20 38 33 30  |cursorloop.  830|
00002480  20 20 20 20 20 20 20 20  20 4a 53 52 20 6f 73 61  |         JSR osa|
00002490  73 63 69 0d 20 20 38 34  30 20 20 20 20 20 20 20  |sci.  840       |
000024a0  20 20 44 45 58 0d 20 20  38 35 30 20 20 20 20 20  |  DEX.  850     |
000024b0  20 20 20 20 42 4e 45 20  63 75 72 73 6f 72 6c 6f  |    BNE cursorlo|
000024c0  6f 70 0d 20 20 38 36 30  20 2e 65 78 69 74 0d 20  |op.  860 .exit. |
000024d0  20 38 37 30 20 20 20 20  20 20 20 20 20 50 4c 41  | 870         PLA|
000024e0  0d 20 20 38 38 30 20 20  20 20 20 20 20 20 20 50  |.  880         P|
000024f0  4c 41 0d 20 20 38 39 30  20 20 20 20 20 20 20 20  |LA.  890        |
00002500  20 50 4c 41 0d 20 20 39  30 30 20 20 20 20 20 20  | PLA.  900      |
00002510  20 20 20 4c 44 41 20 23  30 0d 20 20 39 31 30 20  |   LDA #0.  910 |
00002520  20 20 20 20 20 20 20 20  52 54 53 0d 20 20 39 32  |        RTS.  92|
00002530  30 20 2e 6c 61 73 74 62  79 74 65 0d 20 20 39 33  |0 .lastbyte.  93|
00002540  30 20 5d 0d 20 20 39 34  30 20 4e 45 58 54 0d 20  |0 ].  940 NEXT. |
00002550  20 39 35 30 20 49 4e 50  55 54 27 22 53 61 76 65  | 950 INPUT'"Save|
00002560  20 66 69 6c 65 6e 61 6d  65 20 3d 20 22 66 69 6c  | filename = "fil|
00002570  65 6e 61 6d 65 24 0d 20  20 39 36 30 20 49 46 20  |ename$.  960 IF |
00002580  66 69 6c 65 6e 61 6d 65  24 3d 22 22 20 45 4e 44  |filename$="" END|
00002590  0d 20 20 39 37 30 20 24  73 61 76 65 3d 22 53 41  |.  970 $save="SA|
000025a0  56 45 20 22 2b 66 69 6c  65 6e 61 6d 65 24 2b 22  |VE "+filename$+"|
000025b0  20 22 2b 53 54 52 24 7e  28 48 49 4d 45 4d 29 2b  | "+STR$~(HIMEM)+|
000025c0  22 20 22 2b 53 54 52 24  7e 28 6c 61 73 0d 20 20  |" "+STR$~(las.  |
000025d0  20 20 20 20 74 62 79 74  65 29 2b 22 20 46 46 46  |    tbyte)+" FFF|
000025e0  46 38 30 30 30 20 46 46  46 46 38 30 30 30 22 0d  |F8000 FFFF8000".|
000025f0  20 20 39 38 30 20 58 25  3d 73 61 76 65 20 4d 4f  |  980 X%=save MO|
00002600  44 20 32 35 36 0d 20 20  39 39 30 20 59 25 3d 73  |D 256.  990 Y%=s|
00002610  61 76 65 20 44 49 56 20  32 35 36 0d 20 31 30 30  |ave DIV 256. 100|
00002620  30 20 2a 4f 50 54 31 2c  32 0d 20 31 30 31 30 20  |0 *OPT1,2. 1010 |
00002630  43 41 4c 4c 20 6f 73 63  6c 69 0d 20 31 30 32 30  |CALL oscli. 1020|
00002640  20 2a 4f 50 54 31 2c 30  0d 20 31 30 33 30 20 45  | *OPT1,0. 1030 E|
00002650  4e 44 0d 20 31 30 34 30  20 44 45 46 46 4e 65 71  |ND. 1040 DEFFNeq|
00002660  75 62 28 62 79 74 65 29  0d 20 31 30 35 30 20 3f  |ub(byte). 1050 ?|
00002670  50 25 3d 62 79 74 65 0d  20 31 30 36 30 20 50 25  |P%=byte. 1060 P%|
00002680  3d 50 25 2b 31 0d 20 31  30 37 30 20 3d 70 61 73  |=P%+1. 1070 =pas|
00002690  73 0d 20 31 30 38 30 20  44 45 46 46 4e 65 71 75  |s. 1080 DEFFNequ|
000026a0  77 28 77 6f 72 64 29 0d  20 31 30 39 30 20 3f 50  |w(word). 1090 ?P|
000026b0  25 3d 77 6f 72 64 20 4d  4f 44 20 32 35 36 0d 20  |%=word MOD 256. |
000026c0  31 31 30 30 20 50 25 3f  31 3d 77 6f 72 64 20 44  |1100 P%?1=word D|
000026d0  49 56 20 32 35 36 0d 20  31 31 31 30 20 50 25 3d  |IV 256. 1110 P%=|
000026e0  50 25 2b 32 0d 20 31 31  32 30 20 3d 70 61 73 73  |P%+2. 1120 =pass|
000026f0  0d 20 31 31 33 30 20 44  45 46 46 4e 65 71 75 64  |. 1130 DEFFNequd|
00002700  28 64 6f 75 62 6c 65 29  0d 20 31 31 34 30 20 21  |(double). 1140 !|
00002710  50 25 3d 64 6f 75 62 6c  65 0d 20 31 31 35 30 20  |P%=double. 1150 |
00002720  50 25 3d 50 25 2b 34 0d  20 31 31 36 30 20 3d 70  |P%=P%+4. 1160 =p|
00002730  61 73 73 0d 20 31 31 37  30 20 44 45 46 46 4e 65  |ass. 1170 DEFFNe|
00002740  71 75 73 28 73 74 72 69  6e 67 24 29 0d 20 31 31  |qus(string$). 11|
00002750  38 30 20 24 50 25 3d 73  74 72 69 6e 67 24 0d 20  |80 $P%=string$. |
00002760  31 31 39 30 20 50 25 3d  50 25 2b 4c 45 4e 28 73  |1190 P%=P%+LEN(s|
00002770  74 72 69 6e 67 24 29 0d  20 31 32 30 30 20 3d 70  |tring$). 1200 =p|
00002780  61 73 73 0d                                       |ass.|
00002784