/ APDL Public Domain 1 / APDL_PD1A.iso / program / language / apl / WS / HELP / DFILE

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 07 00 11 03 9b 03 49 04 | 9b 01 5a 03 65 02 0f 03 |......I.|..Z.e...|
|00000010| 0d 0d 0d 0d 0d 0d 0d 44 | 46 49 4c 45 20 57 6f 72 |.......D|FILE Wor|
|00000020| 6b 73 70 61 63 65 0d 0d | 44 46 49 4c 45 20 63 6f |kspace..|DFILE co|
|00000030| 6e 74 61 69 6e 73 20 66 | 75 6e 63 74 69 6f 6e 73 |ntains f|unctions|
|00000040| 20 66 6f 72 20 72 65 61 | 64 69 6e 67 20 61 6e 64 | for rea|ding and|
|00000050| 20 77 72 69 74 69 6e 67 | 20 6e 61 74 69 76 65 20 | writing| native |
|00000060| 41 52 54 48 55 52 2f 52 | 49 53 43 4f 53 20 66 69 |ARTHUR/R|ISCOS fi|
|00000070| 6c 65 73 2e 20 0d 0d 50 | 61 67 65 20 0d 0d 20 31 |les. ..P|age .. 1|
|00000080| 20 20 20 20 5a a2 44 46 | 4f 50 45 4e 20 ff 20 20 |    Z.DF|OPEN .  |
|00000090| 20 20 20 4f 70 65 6e 20 | 66 69 6c 65 20 0d 20 31 |   Open |file . 1|
|000000a0| 20 20 20 20 5a a2 44 46 | 4d 41 4b 45 20 ff 20 20 |    Z.DF|MAKE .  |
|000000b0| 20 20 20 43 72 65 61 74 | 65 20 66 69 6c 65 20 0d |   Creat|e file .|
|000000c0| 20 31 20 20 20 20 5a a2 | 44 46 43 4c 4f 53 45 20 | 1    Z.|DFCLOSE |
|000000d0| 20 20 20 20 20 43 6c 6f | 73 65 20 66 69 6c 65 20 |     Clo|se file |
|000000e0| 0d 20 32 20 20 20 20 5a | a2 a0 20 44 46 52 45 41 |. 2    Z|.. DFREA|
|000000f0| 44 20 ff 20 20 20 52 65 | 61 64 20 63 68 61 72 61 |D .   Re|ad chara|
|00000100| 63 74 65 72 73 20 66 72 | 6f 6d 20 66 69 6c 65 20 |cters fr|om file |
|00000110| 0d 20 32 20 20 20 20 5a | a2 a0 20 44 46 57 52 49 |. 2    Z|.. DFWRI|
|00000120| 54 45 20 ff 20 20 57 72 | 69 74 65 20 63 68 61 72 |TE .  Wr|ite char|
|00000130| 61 63 74 65 72 73 20 74 | 6f 20 66 69 6c 65 20 0d |acters t|o file .|
|00000140| 20 33 20 20 20 20 5a a2 | 44 46 53 49 5a 45 20 20 | 3    Z.|DFSIZE  |
|00000150| 20 20 20 20 20 53 69 7a | 65 20 6f 66 20 66 69 6c |     Siz|e of fil|
|00000160| 65 20 69 6e 20 63 68 61 | 72 61 63 74 65 72 73 20 |e in cha|racters |
|00000170| 0d 20 33 20 20 20 20 5a | a2 44 46 53 45 4c 45 43 |. 3    Z|.DFSELEC|
|00000180| 54 20 ff 20 20 20 53 65 | 6c 65 63 74 20 64 72 69 |T .   Se|lect dri|
|00000190| 76 65 2f 64 69 72 65 63 | 74 6f 72 79 20 0d 20 34 |ve/direc|tory . 4|
|000001a0| 20 20 20 20 5a a2 a0 20 | 44 46 54 59 50 45 20 ff |    Z.. |DFTYPE .|
|000001b0| 20 20 20 46 69 6e 64 2f | 63 6f 6e 76 65 72 74 20 |   Find/|convert |
|000001c0| 74 79 70 65 20 6f 66 20 | 61 72 72 61 79 20 0d 20 |type of |array . |
|000001d0| 35 20 20 20 20 45 78 61 | 6d 70 6c 65 73 20 0d 0d |5    Exa|mples ..|
|000001e0| 4f 6e 6c 79 20 6f 6e 65 | 20 66 69 6c 65 20 61 74 |Only one| file at|
|000001f0| 20 61 20 74 69 6d 65 20 | 6d 61 79 20 62 65 20 6f | a time |may be o|
|00000200| 70 65 6e 2e 20 41 6c 6c | 20 66 69 6c 65 20 72 65 |pen. All| file re|
|00000210| 61 64 69 6e 67 20 61 6e | 64 20 77 72 69 74 69 6e |ading an|d writin|
|00000220| 67 20 69 73 20 64 6f 6e | 65 20 69 6e 20 0d 63 68 |g is don|e in .ch|
|00000230| 61 72 61 63 74 65 72 73 | 2e 20 44 46 54 59 50 45 |aracters|. DFTYPE|
|00000240| 20 61 6c 6c 6f 77 73 20 | 61 72 72 61 79 73 20 74 | allows |arrays t|
|00000250| 6f 20 62 65 20 63 6f 6e | 76 65 72 74 65 64 20 74 |o be con|verted t|
|00000260| 6f 20 61 6e 64 20 66 72 | 6f 6d 20 63 68 61 72 61 |o and fr|om chara|
|00000270| 63 74 65 72 20 61 72 72 | 61 79 73 20 0d 74 6f 20 |cter arr|ays .to |
|00000280| 61 6c 6c 6f 77 20 72 65 | 61 64 69 6e 67 20 61 6e |allow re|ading an|
|00000290| 64 20 77 72 69 74 69 6e | 67 20 6f 66 20 6f 74 68 |d writin|g of oth|
|000002a0| 65 72 20 74 79 70 65 73 | 20 6f 66 20 64 61 74 61 |er types| of data|
|000002b0| 2e 20 0d 0d 54 68 65 72 | 65 20 61 72 65 20 61 20 |. ..Ther|e are a |
|000002c0| 6e 75 6d 62 65 72 20 6f | 66 20 69 6e 74 65 72 6e |number o|f intern|
|000002d0| 61 6c 20 66 75 6e 63 74 | 69 6f 6e 73 20 28 65 2e |al funct|ions (e.|
|000002e0| 67 2e 20 44 46 47 42 29 | 20 61 6e 64 20 73 6f 6d |g. DFGB)| and som|
|000002f0| 65 20 67 6c 6f 62 61 6c | 20 76 61 72 69 61 62 6c |e global| variabl|
|00000300| 65 73 0d 77 68 69 63 68 | 20 73 68 6f 75 6c 64 20 |es.which| should |
|00000310| 6e 6f 74 20 62 65 20 63 | 68 61 6e 67 65 64 2e 0d |not be c|hanged..|
|00000320| 0d 0d 0d 0d 0d 0d 0d 0d | 20 5a a2 44 46 4f 50 45 |........| Z.DFOPE|
|00000330| 4e 20 ff 20 20 20 4f 70 | 65 6e 20 66 69 6c 65 0d |N .   Op|en file.|
|00000340| 0d ff 20 69 73 20 61 20 | 63 68 61 72 61 63 74 65 |.. is a |characte|
|00000350| 72 20 73 63 61 6c 61 72 | 20 6f 72 20 76 65 63 74 |r scalar| or vect|
|00000360| 6f 72 20 66 69 6c 65 20 | 6e 61 6d 65 20 74 6f 20 |or file |name to |
|00000370| 62 65 20 6f 70 65 6e 65 | 64 2e 20 54 68 65 20 72 |be opene|d. The r|
|00000380| 65 73 75 6c 74 20 69 73 | 20 31 20 69 66 0d 74 68 |esult is| 1 if.th|
|00000390| 65 20 66 69 6c 65 20 77 | 61 73 20 73 75 63 63 65 |e file w|as succe|
|000003a0| 73 73 66 75 6c 6c 79 20 | 6f 70 65 6e 65 64 2c 20 |ssfully |opened, |
|000003b0| 6f 72 20 30 20 69 66 20 | 74 68 65 20 66 69 6c 65 |or 0 if |the file|
|000003c0| 20 77 61 73 6e 27 74 20 | 66 6f 75 6e 64 2c 20 6f | wasn't |found, o|
|000003d0| 72 20 69 66 20 61 20 64 | 69 73 6b 0d 65 72 72 6f |r if a d|isk.erro|
|000003e0| 72 20 6f 63 63 75 72 65 | 64 2e 0d 0d 20 5a a2 44 |r occure|d... Z.D|
|000003f0| 46 4d 41 4b 45 20 ff 20 | 20 20 43 72 65 61 74 65 |FMAKE . |  Create|
|00000400| 20 66 69 6c 65 0d 0d ff | 20 69 73 20 61 20 63 68 | file...| is a ch|
|00000410| 61 72 61 63 74 65 72 20 | 73 63 61 6c 61 72 20 6f |aracter |scalar o|
|00000420| 72 20 76 65 63 74 6f 72 | 20 66 69 6c 65 20 6e 61 |r vector| file na|
|00000430| 6d 65 20 74 6f 20 62 65 | 20 63 72 65 61 74 65 64 |me to be| created|
|00000440| 20 61 6e 64 20 6f 70 65 | 6e 65 64 2e 20 49 66 20 | and ope|ned. If |
|00000450| 74 68 65 0d 66 69 6c 65 | 20 65 78 69 73 74 65 64 |the.file| existed|
|00000460| 20 70 72 69 6f 72 20 74 | 6f 20 74 68 65 20 44 46 | prior t|o the DF|
|00000470| 4d 41 4b 45 2c 20 69 74 | 20 69 73 20 64 65 6c 65 |MAKE, it| is dele|
|00000480| 74 65 64 20 77 69 74 68 | 6f 75 74 20 77 61 72 6e |ted with|out warn|
|00000490| 69 6e 67 2e 20 54 68 65 | 20 72 65 73 75 6c 74 20 |ing. The| result |
|000004a0| 69 73 0d 31 20 69 66 20 | 74 68 65 20 66 69 6c 65 |is.1 if |the file|
|000004b0| 20 77 61 73 20 73 75 63 | 63 65 73 73 66 75 6c 6c | was suc|cessfull|
|000004c0| 79 20 63 72 65 61 74 65 | 64 20 61 6e 64 20 6f 70 |y create|d and op|
|000004d0| 65 6e 65 64 2c 20 6f 72 | 20 30 20 69 66 20 74 68 |ened, or| 0 if th|
|000004e0| 65 20 64 69 73 6b 20 69 | 73 20 66 75 6c 6c 20 6f |e disk i|s full o|
|000004f0| 72 0d 61 20 64 69 73 6b | 20 65 72 72 6f 72 20 6f |r.a disk| error o|
|00000500| 63 63 75 72 65 64 2e 0d | 0d 20 5a a2 44 46 43 4c |ccured..|. Z.DFCL|
|00000510| 4f 53 45 20 20 20 20 43 | 6c 6f 73 65 20 66 69 6c |OSE    C|lose fil|
|00000520| 65 0d 0d 54 68 65 20 63 | 75 72 72 65 6e 74 6c 79 |e..The c|urrently|
|00000530| 20 6f 70 65 6e 20 66 69 | 6c 65 2c 20 69 66 20 61 | open fi|le, if a|
|00000540| 6e 79 2c 20 69 73 20 63 | 6c 6f 73 65 64 2e 20 54 |ny, is c|losed. T|
|00000550| 68 65 20 72 65 73 75 6c | 74 20 69 73 20 31 20 69 |he resul|t is 1 i|
|00000560| 66 20 74 68 65 20 66 69 | 6c 65 20 77 61 73 0d 73 |f the fi|le was.s|
|00000570| 75 63 63 65 73 73 66 75 | 6c 6c 79 20 63 6c 6f 73 |uccessfu|lly clos|
|00000580| 65 64 2c 20 6f 72 20 30 | 20 69 66 20 61 20 64 69 |ed, or 0| if a di|
|00000590| 73 6b 20 65 72 72 6f 72 | 20 6f 63 63 75 72 65 64 |sk error| occured|
|000005a0| 2e 0d 0d 4e 6f 74 65 73 | 0d 0d 49 66 20 61 20 66 |...Notes|..If a f|
|000005b0| 69 6c 65 20 69 73 20 61 | 6c 72 65 61 64 79 20 6f |ile is a|lready o|
|000005c0| 70 65 6e 20 77 68 65 6e | 20 44 46 4f 50 45 4e 20 |pen when| DFOPEN |
|000005d0| 6f 72 20 44 46 4d 41 4b | 45 20 69 73 20 75 73 65 |or DFMAK|E is use|
|000005e0| 64 2c 20 69 74 20 69 73 | 20 61 75 74 6f 6d 61 74 |d, it is| automat|
|000005f0| 69 63 61 6c 6c 79 20 0d | 63 6c 6f 73 65 64 20 62 |ically .|closed b|
|00000600| 65 66 6f 72 65 20 74 68 | 65 20 6e 65 77 20 66 69 |efore th|e new fi|
|00000610| 6c 65 20 69 73 20 6f 70 | 65 6e 65 64 2e 20 41 6e |le is op|ened. An|
|00000620| 20 6f 70 65 6e 20 66 69 | 6c 65 20 69 73 20 61 6c | open fi|le is al|
|00000630| 73 6f 20 63 6c 6f 73 65 | 64 20 77 68 65 6e 20 29 |so close|d when )|
|00000640| 4f 46 46 20 69 73 20 0d | 74 79 70 65 64 2e 20 44 |OFF is .|typed. D|
|00000650| 46 43 4c 4f 53 45 20 69 | 73 20 70 72 6f 76 69 64 |FCLOSE i|s provid|
|00000660| 65 64 20 74 6f 20 67 75 | 61 72 64 20 61 67 61 69 |ed to gu|ard agai|
|00000670| 6e 73 74 20 73 79 73 74 | 65 6d 20 63 6f 72 72 75 |nst syst|em corru|
|00000680| 70 74 69 6f 6e 2c 20 61 | 6e 64 20 69 74 73 20 75 |ption, a|nd its u|
|00000690| 73 65 20 69 73 20 0d 72 | 65 63 6f 6d 6d 65 6e 64 |se is .r|ecommend|
|000006a0| 65 64 20 61 66 74 65 72 | 20 77 72 69 74 69 6e 67 |ed after| writing|
|000006b0| 20 74 6f 20 61 20 66 69 | 6c 65 2e 20 0d 0d 0d 0d | to a fi|le. ....|
|000006c0| 0d 0d 0d 20 5a a2 44 46 | 52 45 41 44 20 ff 20 20 |... Z.DF|READ .  |
|000006d0| 20 20 20 20 52 65 61 64 | 20 63 68 61 72 61 63 74 |    Read| charact|
|000006e0| 65 72 73 20 66 72 6f 6d | 20 66 69 6c 65 0d 20 5a |ers from| file. Z|
|000006f0| a2 a0 20 44 46 52 45 41 | 44 20 ff 20 0d 0d ff 20 |.. DFREA|D . ... |
|00000700| 69 73 20 61 20 6e 6f 6e | 6e 65 67 61 74 69 76 65 |is a non|negative|
|00000710| 20 69 6e 74 65 67 65 72 | 20 67 69 76 69 6e 67 20 | integer| giving |
|00000720| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 63 68 |the numb|er of ch|
|00000730| 61 72 61 63 74 65 72 73 | 20 74 6f 20 62 65 20 72 |aracters| to be r|
|00000740| 65 61 64 2e 20 49 66 20 | a0 20 69 73 20 0d 6e 6f |ead. If |. is .no|
|00000750| 74 20 67 69 76 65 6e 2c | 20 74 68 65 20 66 69 6c |t given,| the fil|
|00000760| 65 20 72 65 61 64 20 62 | 65 67 69 6e 73 20 77 68 |e read b|egins wh|
|00000770| 65 72 65 20 74 68 65 20 | 6c 61 73 74 20 66 69 6c |ere the |last fil|
|00000780| 65 20 72 65 61 64 20 6f | 72 20 77 72 69 74 65 20 |e read o|r write |
|00000790| 66 69 6e 69 73 68 65 64 | 2c 20 6f 72 20 0d 61 74 |finished|, or .at|
|000007a0| 20 30 20 69 66 20 74 68 | 65 20 66 69 6c 65 20 68 | 0 if th|e file h|
|000007b0| 61 73 20 6a 75 73 74 20 | 62 65 65 6e 20 6f 70 65 |as just |been ope|
|000007c0| 6e 65 64 2e 20 49 66 20 | a0 20 69 73 20 67 69 76 |ned. If |. is giv|
|000007d0| 65 6e 2c 20 69 74 20 69 | 73 20 61 20 6e 6f 6e 6e |en, it i|s a nonn|
|000007e0| 65 67 61 74 69 76 65 20 | 0d 69 6e 74 65 67 65 72 |egative |.integer|
|000007f0| 20 67 69 76 69 6e 67 20 | 74 68 65 20 63 68 61 72 | giving |the char|
|00000800| 61 63 74 65 72 20 6f 66 | 66 73 65 74 20 69 6e 20 |acter of|fset in |
|00000810| 74 68 65 20 66 69 6c 65 | 20 77 68 65 72 65 20 74 |the file| where t|
|00000820| 68 65 20 72 65 61 64 20 | 69 73 20 74 6f 20 62 65 |he read |is to be|
|00000830| 67 69 6e 2e 20 54 68 65 | 0d 72 65 73 75 6c 74 20 |gin. The|.result |
|00000840| 69 73 20 61 20 63 68 61 | 72 61 63 74 65 72 20 76 |is a cha|racter v|
|00000850| 65 63 74 6f 72 20 6f 66 | 20 74 68 65 20 64 61 74 |ector of| the dat|
|00000860| 61 20 72 65 61 64 2c 20 | 6f 72 20 61 20 30 20 69 |a read, |or a 0 i|
|00000870| 66 20 61 20 64 69 73 6b | 20 65 72 72 6f 72 20 6f |f a disk| error o|
|00000880| 63 63 75 72 65 64 2e 20 | 0d 49 66 20 69 74 20 69 |ccured. |.If it i|
|00000890| 73 20 61 20 63 68 61 72 | 61 63 74 65 72 20 76 65 |s a char|acter ve|
|000008a0| 63 74 6f 72 2c 20 74 68 | 65 20 72 65 73 75 6c 74 |ctor, th|e result|
|000008b0| 20 6d 61 79 20 68 61 76 | 65 20 6c 65 6e 67 74 68 | may hav|e length|
|000008c0| 20 6c 65 73 73 20 74 68 | 61 6e 20 ff 20 69 66 20 | less th|an . if |
|000008d0| 65 6e 64 20 6f 66 20 0d | 66 69 6c 65 20 77 61 73 |end of .|file was|
|000008e0| 20 65 6e 63 6f 75 6e 74 | 65 72 65 64 2e 20 0d 0d | encount|ered. ..|
|000008f0| 20 5a a2 44 46 57 52 49 | 54 45 20 ff 20 20 20 20 | Z.DFWRI|TE .    |
|00000900| 20 57 72 69 74 65 20 63 | 68 61 72 61 63 74 65 72 | Write c|haracter|
|00000910| 73 20 74 6f 20 66 69 6c | 65 20 0d 20 5a a2 a0 20 |s to fil|e . Z.. |
|00000920| 44 46 57 52 49 54 45 20 | ff 20 0d 0d ff 20 69 73 |DFWRITE |. ... is|
|00000930| 20 61 20 63 68 61 72 61 | 63 74 65 72 20 73 63 61 | a chara|cter sca|
|00000940| 6c 61 72 20 6f 72 20 76 | 65 63 74 6f 72 20 6f 66 |lar or v|ector of|
|00000950| 20 64 61 74 61 20 74 6f | 20 62 65 20 77 72 69 74 | data to| be writ|
|00000960| 74 65 6e 2e 20 49 66 20 | a0 20 69 73 20 6e 6f 74 |ten. If |. is not|
|00000970| 20 67 69 76 65 6e 2c 20 | 74 68 65 0d 66 69 6c 65 | given, |the.file|
|00000980| 20 77 72 69 74 65 20 62 | 65 67 69 6e 73 20 77 68 | write b|egins wh|
|00000990| 65 72 65 20 74 68 65 20 | 6c 61 73 74 20 66 69 6c |ere the |last fil|
|000009a0| 65 20 72 65 61 64 20 6f | 72 20 77 72 69 74 65 20 |e read o|r write |
|000009b0| 66 69 6e 69 73 68 65 64 | 2c 20 6f 72 20 61 74 20 |finished|, or at |
|000009c0| 30 20 69 66 20 74 68 65 | 20 0d 66 69 6c 65 20 68 |0 if the| .file h|
|000009d0| 61 73 20 6a 75 73 74 20 | 62 65 65 6e 20 6f 70 65 |as just |been ope|
|000009e0| 6e 65 64 2e 20 49 66 20 | a0 20 69 73 20 67 69 76 |ned. If |. is giv|
|000009f0| 65 6e 2c 20 69 74 20 69 | 73 20 61 20 6e 6f 6e 6e |en, it i|s a nonn|
|00000a00| 65 67 61 74 69 76 65 20 | 69 6e 74 65 67 65 72 20 |egative |integer |
|00000a10| 67 69 76 69 6e 67 20 0d | 74 68 65 20 63 68 61 72 |giving .|the char|
|00000a20| 61 63 74 65 72 20 6f 66 | 66 73 65 74 20 69 6e 20 |acter of|fset in |
|00000a30| 74 68 65 20 66 69 6c 65 | 20 77 68 65 72 65 20 74 |the file| where t|
|00000a40| 68 65 20 72 65 61 64 20 | 69 73 20 74 6f 20 62 65 |he read |is to be|
|00000a50| 67 69 6e 2e 20 54 68 65 | 20 72 65 73 75 6c 74 20 |gin. The| result |
|00000a60| 69 73 20 74 68 65 20 0d | 6e 75 6d 62 65 72 20 6f |is the .|number o|
|00000a70| 66 20 63 68 61 72 61 63 | 74 65 72 73 20 61 63 74 |f charac|ters act|
|00000a80| 75 61 6c 6c 79 20 77 72 | 69 74 74 65 6e 2c 20 6f |ually wr|itten, o|
|00000a90| 72 20 b8 31 20 69 66 20 | 61 20 64 69 73 6b 20 65 |r .1 if |a disk e|
|00000aa0| 72 72 6f 72 20 6f 63 63 | 75 72 65 64 2e 20 49 66 |rror occ|ured. If|
|00000ab0| 20 69 74 20 0d 6e 6f 6e | 6e 65 67 61 74 69 76 65 | it .non|negative|
|00000ac0| 2c 20 74 68 65 20 72 65 | 73 75 6c 74 20 6d 61 79 |, the re|sult may|
|00000ad0| 20 62 65 20 6c 65 73 73 | 20 74 68 61 6e 20 74 68 | be less| than th|
|00000ae0| 65 20 73 69 7a 65 20 6f | 66 20 ff 20 69 66 20 74 |e size o|f . if t|
|00000af0| 68 65 20 64 69 73 6b 20 | 69 73 20 66 75 6c 6c 2e |he disk |is full.|
|00000b00| 20 0d 0d 0d 0d 0d 0d 0d | 0d 0d 0d 0d 20 5a a2 44 | .......|.... Z.D|
|00000b10| 46 53 49 5a 45 20 20 20 | 20 20 53 69 7a 65 20 6f |FSIZE   |  Size o|
|00000b20| 66 20 66 69 6c 65 20 69 | 6e 20 63 68 61 72 61 63 |f file i|n charac|
|00000b30| 74 65 72 73 0d 0d 5a 20 | 69 73 20 74 68 65 20 73 |ters..Z |is the s|
|00000b40| 69 7a 65 20 6f 66 20 74 | 68 65 20 63 75 72 72 65 |ize of t|he curre|
|00000b50| 6e 74 6c 79 20 6f 70 65 | 6e 65 64 20 66 69 6c 65 |ntly ope|ned file|
|00000b60| 20 69 6e 20 62 79 74 65 | 73 2c 20 6f 72 20 b8 31 | in byte|s, or .1|
|00000b70| 20 69 66 20 74 68 65 20 | 73 69 7a 65 20 69 73 20 | if the |size is |
|00000b80| 0d 6c 61 72 67 65 72 20 | 74 68 61 6e 20 33 32 37 |.larger |than 327|
|00000b90| 36 37 2e 20 0d 0d 20 5a | a2 44 46 53 45 4c 45 43 |67. .. Z|.DFSELEC|
|00000ba0| 54 20 ff 20 0d 0d ff 20 | 69 73 20 61 20 64 69 72 |T . ... |is a dir|
|00000bb0| 65 63 74 6f 72 79 20 70 | 61 74 68 2c 20 77 68 69 |ectory p|ath, whi|
|00000bc0| 63 68 20 6d 61 79 20 69 | 6e 63 6c 75 64 65 20 61 |ch may i|nclude a|
|00000bd0| 20 64 72 69 76 65 20 73 | 70 65 63 69 66 69 63 61 | drive s|pecifica|
|00000be0| 74 69 6f 6e 2e 20 54 68 | 65 20 64 69 72 65 63 74 |tion. Th|e direct|
|00000bf0| 6f 72 79 20 0d 67 69 76 | 65 6e 20 69 73 20 73 65 |ory .giv|en is se|
|00000c00| 6c 65 63 74 65 64 20 74 | 6f 20 62 65 20 74 68 65 |lected t|o be the|
|00000c10| 20 6e 65 77 20 63 75 72 | 72 65 6e 74 20 64 69 72 | new cur|rent dir|
|00000c20| 65 63 74 6f 72 79 2e 20 | 49 66 20 61 20 66 69 6c |ectory. |If a fil|
|00000c30| 65 20 69 73 20 6f 70 65 | 6e 2c 20 69 74 20 69 73 |e is ope|n, it is|
|00000c40| 20 0d 73 74 69 6c 6c 20 | 69 6e 20 74 68 65 20 6f | .still |in the o|
|00000c50| 72 69 67 69 6e 61 6c 20 | 64 69 72 65 63 74 6f 72 |riginal |director|
|00000c60| 79 2e 20 41 6e 79 20 6e | 65 77 20 66 69 6c 65 20 |y. Any n|ew file |
|00000c70| 6f 70 65 6e 65 64 20 77 | 69 6c 6c 20 62 65 20 69 |opened w|ill be i|
|00000c80| 6e 20 74 68 69 73 20 64 | 69 72 65 63 74 6f 72 79 |n this d|irectory|
|00000c90| 2e 0d 0d 20 0d 0d 0d 0d | 0d 0d 0d 0d 0d 0d 0d 0d |... ....|........|
|00000ca0| 0d 0d 0d 0d 0d 0d 0d 20 | 5a a2 44 46 54 59 50 45 |....... |Z.DFTYPE|
|00000cb0| 20 ff 20 20 20 20 20 46 | 69 6e 64 2f 63 6f 6e 76 | .     F|ind/conv|
|00000cc0| 65 72 74 20 74 79 70 65 | 20 6f 66 20 61 72 72 61 |ert type| of arra|
|00000cd0| 79 0d 20 5a a2 a0 20 44 | 46 54 59 50 45 20 ff 0d |y. Z.. D|FTYPE ..|
|00000ce0| 0d 49 66 20 a0 20 69 73 | 20 6e 6f 74 20 67 69 76 |.If . is| not giv|
|00000cf0| 65 6e 2c 20 ff 20 6d 61 | 79 20 62 65 20 61 6e 79 |en, . ma|y be any|
|00000d00| 20 61 72 72 61 79 2e 20 | 54 68 65 20 72 65 73 75 | array. |The resu|
|00000d10| 6c 74 20 69 73 20 61 20 | 73 63 61 6c 61 72 20 76 |lt is a |scalar v|
|00000d20| 61 6c 75 65 20 61 63 63 | 6f 72 64 69 6e 67 0d 74 |alue acc|ording.t|
|00000d30| 6f 20 74 68 65 20 69 6e | 74 65 72 6e 61 6c 20 74 |o the in|ternal t|
|00000d40| 79 70 65 20 6f 66 20 ff | 2c 20 61 73 20 66 6f 6c |ype of .|, as fol|
|00000d50| 6c 6f 77 73 3a 0d 0d 20 | 30 20 20 62 6f 6f 6c 65 |lows:.. |0  boole|
|00000d60| 61 6e 20 28 31 2f 38 20 | 62 79 74 65 20 70 65 72 |an (1/8 |byte per|
|00000d70| 20 65 6c 65 6d 65 6e 74 | 29 0d 20 31 20 20 63 68 | element|). 1  ch|
|00000d80| 61 72 61 63 74 65 72 20 | 28 31 20 62 79 74 65 20 |aracter |(1 byte |
|00000d90| 70 65 72 20 65 6c 65 6d | 65 6e 74 29 0d 20 32 20 |per elem|ent). 2 |
|00000da0| 20 69 6e 74 65 67 65 72 | 20 28 32 20 62 79 74 65 | integer| (2 byte|
|00000db0| 73 20 70 65 72 20 65 6c | 65 6d 65 6e 74 29 0d 20 |s per el|ement). |
|00000dc0| 36 20 20 66 6c 6f 61 74 | 69 6e 67 20 70 6f 69 6e |6  float|ing poin|
|00000dd0| 74 20 28 36 20 62 79 74 | 65 73 20 70 65 72 20 65 |t (6 byt|es per e|
|00000de0| 6c 65 6d 65 6e 74 29 0d | 0d 49 66 20 a0 20 69 73 |lement).|.If . is|
|00000df0| 20 67 69 76 65 6e 2c 20 | 69 74 20 6d 75 73 74 20 | given, |it must |
|00000e00| 62 65 20 6f 6e 65 20 6f | 66 20 74 68 65 20 61 62 |be one o|f the ab|
|00000e10| 6f 76 65 20 69 6e 74 65 | 67 65 72 73 2c 20 61 6e |ove inte|gers, an|
|00000e20| 64 20 ff 20 6d 75 73 74 | 20 6e 6f 74 20 62 65 20 |d . must| not be |
|00000e30| 61 0d 73 63 61 6c 61 72 | 2e 20 54 68 65 20 72 65 |a.scalar|. The re|
|00000e40| 73 75 6c 74 20 69 73 20 | 61 6e 20 61 72 72 61 79 |sult is |an array|
|00000e50| 20 6f 66 20 74 79 70 65 | 20 a0 20 63 6f 6d 70 72 | of type| . compr|
|00000e60| 69 73 69 6e 67 20 74 68 | 65 20 73 61 6d 65 20 6e |ising th|e same n|
|00000e70| 75 6d 62 65 72 20 6f 66 | 20 62 79 74 65 73 20 61 |umber of| bytes a|
|00000e80| 73 0d ff 2e 20 54 68 65 | 20 73 68 61 70 65 20 6f |s... The| shape o|
|00000e90| 66 20 74 68 65 20 72 65 | 73 75 6c 74 20 69 73 20 |f the re|sult is |
|00000ea0| 74 68 65 20 73 61 6d 65 | 20 61 73 20 74 68 65 20 |the same| as the |
|00000eb0| 73 61 6d 65 20 6f 66 20 | ff 2c 20 65 78 63 65 70 |same of |., excep|
|00000ec0| 74 20 74 68 61 74 20 74 | 68 65 20 6c 61 73 74 0d |t that t|he last.|
|00000ed0| 61 78 69 73 20 6f 66 20 | 74 68 65 20 72 65 73 75 |axis of |the resu|
|00000ee0| 6c 74 20 69 73 20 61 64 | 6a 75 73 74 65 64 20 61 |lt is ad|justed a|
|00000ef0| 63 63 6f 72 64 69 6e 67 | 20 74 6f 20 74 68 65 20 |ccording| to the |
|00000f00| 66 6f 6c 6c 6f 77 69 6e | 67 20 72 65 6c 61 74 69 |followin|g relati|
|00000f10| 6f 6e 73 68 69 70 3a 0d | 0d 20 20 20 20 20 20 20 |onship:.|.       |
|00000f20| 28 b8 31 a4 bc 5a 29 20 | a2 a3 20 28 b8 31 a4 bc |(.1..Z) |.. (.1..|
|00000f30| ff 29 b6 b0 2f 2e 31 32 | 35 20 31 20 32 20 36 5b |.)../.12|5 1 2 6[|
|00000f40| 30 20 31 20 32 20 36 b3 | 28 44 46 54 59 50 45 20 |0 1 2 6.|(DFTYPE |
|00000f50| ff 29 2c a0 5d 0d 0d 54 | 68 65 20 6f 70 65 72 61 |.),.]..T|he opera|
|00000f60| 74 69 6f 6e 20 77 69 6c | 6c 20 73 75 63 63 65 65 |tion wil|l succee|
|00000f70| 64 20 6f 6e 6c 79 20 69 | 66 20 74 68 65 20 72 69 |d only i|f the ri|
|00000f80| 67 68 74 20 68 61 6e 64 | 20 65 78 70 72 65 73 73 |ght hand| express|
|00000f90| 69 6f 6e 20 69 73 20 61 | 6e 20 69 6e 74 65 67 65 |ion is a|n intege|
|00000fa0| 72 20 6c 65 73 73 0d 74 | 68 61 6e 20 33 32 37 36 |r less.t|han 3276|
|00000fb0| 37 2c 20 61 6e 64 20 74 | 68 65 20 74 6f 74 61 6c |7, and t|he total|
|00000fc0| 20 6e 75 6d 62 65 72 20 | 6f 66 20 65 6c 65 6d 65 | number |of eleme|
|00000fd0| 6e 74 73 20 69 6e 20 74 | 68 65 20 72 65 73 75 6c |nts in t|he resul|
|00000fe0| 74 20 69 73 20 6c 65 73 | 73 20 74 68 61 6e 20 33 |t is les|s than 3|
|00000ff0| 32 37 36 38 2e 20 0d 0d | 0d 0d 0d 0d 0d 0d 0d 0d |2768. ..|........|
|00001000| 0d 45 78 61 6d 70 6c 65 | 73 0d 0d 20 20 20 20 20 |.Example|s..     |
|00001010| 20 20 44 46 4d 41 4b 45 | 27 54 45 53 54 27 20 bd |  DFMAKE|'TEST' .|
|00001020| 20 43 72 65 61 74 65 20 | 61 20 6e 65 77 20 66 69 | Create |a new fi|
|00001030| 6c 65 20 63 61 6c 6c 65 | 64 20 54 45 53 54 20 0d |le calle|d TEST .|
|00001040| 20 31 20 0d 20 20 20 20 | 20 20 20 44 46 57 52 49 | 1 .    |   DFWRI|
|00001050| 54 45 20 27 41 42 43 44 | 45 46 47 48 49 4a 4b 4c |TE 'ABCD|EFGHIJKL|
|00001060| 4d 4e 4f 50 51 52 53 54 | 55 56 57 58 59 5a 27 20 |MNOPQRST|UVWXYZ' |
|00001070| bd 20 57 72 69 74 65 20 | 74 68 65 20 61 6c 70 68 |. Write |the alph|
|00001080| 61 62 65 74 20 0d 20 33 | 20 0d 20 20 20 20 20 20 |abet . 3| .      |
|00001090| 20 34 20 44 46 57 52 49 | 54 45 20 27 48 45 4c 4c | 4 DFWRI|TE 'HELL|
|000010a0| 4f 27 20 bd 20 57 72 69 | 74 65 20 48 45 4c 4c 4f |O' . Wri|te HELLO|
|000010b0| 20 61 74 20 6f 66 66 73 | 65 74 20 34 20 0d 20 35 | at offs|et 4 . 5|
|000010c0| 20 0d 20 20 20 20 20 20 | 20 44 46 53 49 5a 45 20 | .      | DFSIZE |
|000010d0| 44 46 57 52 49 54 45 20 | 27 47 4f 4f 44 42 59 45 |DFWRITE |'GOODBYE|
|000010e0| 27 20 bd 20 57 72 69 74 | 65 20 47 4f 4f 44 42 59 |' . Writ|e GOODBY|
|000010f0| 45 20 61 74 20 74 68 65 | 20 65 6e 64 20 0d 20 37 |E at the| end . 7|
|00001100| 20 0d 20 20 20 20 20 20 | 20 44 46 43 4c 4f 53 45 | .      | DFCLOSE|
|00001110| 20 bd 20 43 6c 6f 73 65 | 20 74 68 65 20 66 69 6c | . Close| the fil|
|00001120| 65 20 0d 20 31 20 0d 20 | 20 20 20 20 20 20 44 46 |e . 1 . |      DF|
|00001130| 4f 50 45 4e 20 27 54 45 | 53 54 27 20 bd 20 52 65 |OPEN 'TE|ST' . Re|
|00001140| 2d 6f 70 65 6e 20 74 68 | 65 20 66 69 6c 65 20 0d |-open th|e file .|
|00001150| 20 31 20 0d 20 20 20 20 | 20 20 20 44 46 53 49 5a | 1 .    |   DFSIZ|
|00001160| 45 20 bd 20 47 65 74 20 | 74 68 65 20 73 69 7a 65 |E . Get |the size|
|00001170| 20 6f 66 20 74 68 65 20 | 66 69 6c 65 20 0d 20 33 | of the |file . 3|
|00001180| 33 20 0d 20 20 20 20 20 | 20 20 44 46 52 45 41 44 |3 .     |  DFREAD|
|00001190| 20 44 46 53 49 5a 45 20 | 20 bd 20 52 65 61 64 20 | DFSIZE | . Read |
|000011a0| 74 68 65 20 77 68 6f 6c | 65 20 66 69 6c 65 20 0d |the whol|e file .|
|000011b0| 20 41 42 43 44 48 45 4c | 4c 4f 4a 4b 4c 4d 4e 4f | ABCDHEL|LOJKLMNO|
|000011c0| 50 51 52 53 54 55 56 57 | 58 59 5a 47 4f 4f 44 42 |PQRSTUVW|XYZGOODB|
|000011d0| 59 45 20 0d 20 20 20 20 | 20 20 20 32 36 20 44 46 |YE .    |   26 DF|
|000011e0| 52 45 41 44 20 31 30 30 | 20 bd 20 54 72 79 20 74 |READ 100| . Try t|
|000011f0| 6f 20 72 65 61 64 20 31 | 30 30 20 63 68 61 72 61 |o read 1|00 chara|
|00001200| 63 74 65 72 73 20 66 72 | 6f 6d 20 6f 66 66 73 65 |cters fr|om offse|
|00001210| 74 20 34 20 0d 20 47 4f | 4f 44 42 59 45 20 0d 20 |t 4 . GO|ODBYE . |
|00001220| 20 20 20 20 20 20 bc 32 | 36 20 44 46 52 45 41 44 |      .2|6 DFREAD|
|00001230| 20 31 30 30 20 bd 20 48 | 6f 77 20 6d 61 6e 79 20 | 100 . H|ow many |
|00001240| 63 68 61 72 61 63 74 65 | 72 73 20 61 63 74 75 61 |characte|rs actua|
|00001250| 6c 6c 79 20 72 65 61 64 | 20 0d 20 37 20 0d 0d 0d |lly read| . 7 ...|
|00001260| 0d 0d 0d 0d 0d 0d 45 78 | 61 6d 70 6c 65 73 0d 0d |......Ex|amples..|
|00001270| 20 20 20 20 20 20 20 44 | 46 53 45 4c 45 43 54 20 |       D|FSELECT |
|00001280| 27 3a 30 2e 24 2e 57 53 | 32 27 20 bd 20 53 65 6c |':0.$.WS|2' . Sel|
|00001290| 65 63 74 20 61 20 6e 65 | 77 20 64 69 72 65 63 74 |ect a ne|w direct|
|000012a0| 6f 72 79 20 6f 6e 20 64 | 72 69 76 65 20 30 0d 20 |ory on d|rive 0. |
|000012b0| 31 20 0d 20 20 20 20 20 | 20 20 44 46 4d 41 4b 45 |1 .     |  DFMAKE|
|000012c0| 20 27 54 45 53 54 27 20 | bd 20 43 72 65 61 74 65 | 'TEST' |. Create|
|000012d0| 20 61 20 66 69 6c 65 20 | 0d 20 31 20 0d 20 20 20 | a file |. 1 .   |
|000012e0| 20 20 20 20 bc 31 20 44 | 46 54 59 50 45 20 b3 31 |    .1 D|FTYPE .1|
|000012f0| 30 20 bd 20 48 6f 77 20 | 62 69 67 20 69 73 20 b3 |0 . How |big is .|
|00001300| 31 30 20 61 73 20 61 20 | 63 68 61 72 61 63 74 65 |10 as a |characte|
|00001310| 72 20 76 65 63 74 6f 72 | 20 0d 20 32 30 20 0d 20 |r vector| . 20 . |
|00001320| 20 20 20 20 20 20 44 46 | 57 52 49 54 45 20 31 20 |      DF|WRITE 1 |
|00001330| 44 46 54 59 50 45 20 b3 | 31 30 20 bd 20 57 72 69 |DFTYPE .|10 . Wri|
|00001340| 74 65 20 b3 31 30 20 74 | 6f 20 74 68 65 20 66 69 |te .10 t|o the fi|
|00001350| 6c 65 20 0d 20 32 30 20 | 0d 20 20 20 20 20 20 20 |le . 20 |.       |
|00001360| 30 20 44 46 52 45 41 44 | 20 32 30 20 bd 20 52 65 |0 DFREAD| 20 . Re|
|00001370| 61 64 20 69 74 20 62 61 | 63 6b 20 61 73 20 61 20 |ad it ba|ck as a |
|00001380| 63 68 61 72 61 63 74 65 | 72 20 76 65 63 74 6f 72 |characte|r vector|
|00001390| 20 0d 20 9f 9f 9f 9f 9f | 9f 9f 9f 9f 9f 9f 9f 9f | . .....|........|
|000013a0| 9f 9f 9f 9f 9f 9f 9f 20 | 0d 20 20 20 20 20 20 20 |....... |.       |
|000013b0| b9 41 56 b3 30 20 44 46 | 52 45 41 44 20 32 30 20 |.AV.0 DF|READ 20 |
|000013c0| bd 20 57 68 65 72 65 20 | 61 72 65 20 74 68 65 73 |. Where |are thes|
|000013d0| 65 20 63 68 61 72 61 63 | 74 65 72 73 20 69 6e 20 |e charac|ters in |
|000013e0| b9 41 56 20 28 b9 49 4f | 20 69 73 20 31 29 20 0d |.AV (.IO| is 1) .|
|000013f0| 20 32 20 31 20 33 20 31 | 20 34 20 31 20 35 20 31 | 2 1 3 1| 4 1 5 1|
|00001400| 20 36 20 31 20 37 20 31 | 20 38 20 31 20 39 20 31 | 6 1 7 1| 8 1 9 1|
|00001410| 20 31 30 20 31 20 31 31 | 20 31 20 0d 20 20 20 20 | 10 1 11| 1 .    |
|00001420| 20 20 20 32 20 44 46 54 | 59 50 45 20 30 20 44 46 |   2 DFT|YPE 0 DF|
|00001430| 52 45 41 44 20 32 30 20 | bd 20 52 65 61 64 20 62 |READ 20 |. Read b|
|00001440| 61 63 6b 20 74 68 65 20 | 69 6e 74 65 67 65 72 20 |ack the |integer |
|00001450| 76 65 63 74 6f 72 20 0d | 20 31 20 32 20 33 20 34 |vector .| 1 2 3 4|
|00001460| 20 35 20 36 20 37 20 38 | 20 39 20 31 30 20 0d 20 | 5 6 7 8| 9 10 . |
|00001470| 20 20 20 20 20 20 b9 a2 | 58 a2 3f 28 3f 31 30 29 |      ..|X.?(?10)|
|00001480| bc 31 30 20 bd 20 53 65 | 74 20 75 70 20 61 20 72 |.10 . Se|t up a r|
|00001490| 61 6e 64 6f 6d 20 69 6e | 74 65 67 65 72 20 76 65 |andom in|teger ve|
|000014a0| 63 74 6f 72 20 0d 20 34 | 20 37 20 32 20 31 20 31 |ctor . 4| 7 2 1 1|
|000014b0| 20 33 20 0d 20 20 20 20 | 20 20 20 30 20 44 46 57 | 3 .    |   0 DFW|
|000014c0| 52 49 54 45 20 31 20 44 | 46 54 59 50 45 20 bc 58 |RITE 1 D|FTYPE .X|
|000014d0| 20 bd 20 57 72 69 74 65 | 20 69 74 73 20 6c 65 6e | . Write| its len|
|000014e0| 67 74 68 20 0d 20 32 20 | 0d 20 20 20 20 20 20 20 |gth . 2 |.       |
|000014f0| 44 46 57 52 49 54 45 20 | 31 20 44 46 54 59 50 45 |DFWRITE |1 DFTYPE|
|00001500| 20 58 20 bd 20 57 72 69 | 74 65 20 74 68 65 20 76 | X . Wri|te the v|
|00001510| 65 63 74 6f 72 20 0d 20 | 31 32 20 0d 20 20 20 20 |ector . |12 .    |
|00001520| 20 20 20 32 20 44 46 54 | 59 50 45 20 44 46 52 45 |   2 DFT|YPE DFRE|
|00001530| 41 44 20 32 b6 32 20 44 | 46 54 59 50 45 20 30 20 |AD 2.2 D|FTYPE 0 |
|00001540| 44 46 52 45 41 44 20 32 | 20 bd 20 52 65 61 64 20 |DFREAD 2| . Read |
|00001550| 62 61 63 6b 20 74 68 65 | 20 76 65 63 74 6f 72 20 |back the| vector |
|00001560| 0d 20 34 20 37 20 32 20 | 31 20 31 20 33 20       |. 4 7 2 |1 1 3   |
+--------+-------------------------+-------------------------+--------+--------+