_  __   _  _         _ _     _      _           _           
  __| |/ /_ | || |     __| (_)___| | __ (_)_ __   __| | _____  __
 / _` | '_ \| || |_   / _` | / __| |/ / | | '_ \ / _` |/ _ \ \/ /
| (_| | (_) |__   _| | (_| | \__ \   <  | | | | | (_| |  __/>  < 
 \__,_|\___/   |_|    \__,_|_|___/_|\_\ |_|_| |_|\__,_|\___/_/\_\

RETURNCODES.DOC

FILE INFORMATION

FILENAME(S): RETURNCODES.DOC

FILE TYPE(S): PRG

FILE SIZE: 512b

FIRST SEEN: 2025-11-30 16:59:22

APPEARS ON: 2 disk(s)

FILE HASH

49c4579d37e9f04596d0531a6331bdb1ea61b54cee9f91427c4346778fef58d6

FOUND ON DISKS (2 DISKS)

DISK TITLE FILENAME FILE TYPE COLLECTION TRACK SECTOR ACTIONS
ASTERIX RETURNCODES.DOC PRG High Voltage Complete C64 Collection 15 0 DOWNLOAD FILE
ASTERISK RETURNCODES.DOC PRG High Voltage Complete C64 Collection 21 6 DOWNLOAD FILE

FILE CONTENT & ANALYSIS

00000000: 20 20 20 20 20 20 20 22  52 65 74 75 72 6E 28 29  |       "Return()|
00000010: 22 20 63 6F 64 65 73 0D  0D 57 68 65 6E 20 61 20  |" codes..When a |
00000020: 70 72 6F 67 72 61 6D 20  65 78 69 74 73 20 74 6F  |program exits to|
00000030: 20 74 68 65 20 73 68 65  6C 6C 2C 20 74 68 65 0D  | the shell, the.|
00000040: 20 20 20 63 61 72 72 79  20 66 6C 61 67 20 69 73  |   carry flag is|
00000050: 20 73 65 74 20 6F 72 20  63 6C 65 61 72 65 64 20  | set or cleared |
00000060: 74 6F 0D 20 20 20 73 69  67 6E 61 6C 20 69 66 20  |to.   signal if |
00000070: 61 6E 20 65 72 72 6F 72  20 6F 63 63 75 72 65 64  |an error occured|
00000080: 2E 0D 0D 20 20 20 49 66  20 63 61 72 72 79 20 73  |...   If carry s|
00000090: 65 74 20 28 45 72 72 6F  72 29 2C 20 74 68 65 6E  |et (Error), then|
000000A0: 20 74 68 65 0D 20 20 20  61 63 63 75 6D 75 6C 61  | the.   accumula|
000000B0: 74 6F 72 20 63 6F 6E 74  61 69 6E 73 20 74 68 65  |tor contains the|
000000C0: 20 65 72 72 6F 72 0D 20  20 20 6E 75 6D 62 65 72  | error.   number|
000000D0: 2E 0D 0D 20 20 20 49 66  20 63 61 72 72 79 20 63  |...   If carry c|
000000E0: 6C 65 61 72 2C 20 74 68  65 6E 20 74 68 65 20 61  |lear, then the a|
000000F0: 63 63 75 6D 75 6C 61 74  6F 72 0D 20 20 20 63 6F  |ccumulator.   co|
00000100: 6E 74 61 69 6E 73 3A 0D  0D 20 20 20 20 20 20 20  |ntains:..       |
00000110: 30 20 2D 2D 20 46 69 6E  69 73 68 65 64 2C 20 65  |0 -- Finished, e|
00000120: 76 65 72 79 74 68 69 6E  67 20 41 2D 4F 4B 2C 0D  |verything A-OK,.|
00000130: 20 20 20 20 20 20 20 20  20 20 20 20 67 6F 20 74  |            go t|
00000140: 6F 20 6E 65 78 74 20 22  73 65 6E 74 65 6E 63 65  |o next "sentence|
00000150: 22 2E 0D 0D 20 20 20 20  20 20 20 31 20 2D 2D 20  |"...       1 -- |
00000160: 46 69 6E 69 73 68 65 64  2C 20 62 75 74 20 69 66  |Finished, but if|
00000170: 20 61 6E 79 20 6D 6F 72  65 0D 20 20 20 20 20 20  | any more.      |
00000180: 20 20 20 20 20 20 6E 6F  75 6E 73 20 63 61 6E 20  |      nouns can |
00000190: 62 65 20 70 61 73 73 65  64 2C 20 74 68 65 6E 0D  |be passed, then.|
000001A0: 20 20 20 20 20 20 20 20  20 20 20 20 72 65 2D 72  |            re-r|
000001B0: 75 6E 20 70 72 6F 67 72  61 6D 0D 20 20 20 20 20  |un program.     |
000001C0: 20 20 20 20 20 20 20 28  75 73 65 64 20 62 79 20  |       (used by |
000001D0: 52 4D 2C 20 65 74 63 2C  20 74 6F 20 61 63 74 0D  |RM, etc, to act.|
000001E0: 20 20 20 20 20 20 20 20  20 20 20 20 20 6F 6E 20  |             on |
000001F0: 6D 75 6C 74 69 70 6C 65  20 66 69 6C 65 73 29 0D  |multiple files).|

       "RETURN()" CODES..WHEN A PROGRAM 
EXITS TO THE SHELL, THE.   CARRY FLAG IS
 SET OR CLEARED TO.   SIGNAL IF AN ERROR
 OCCURED...   IF CARRY SET (ERROR), THEN
 THE.   ACCUMULATOR CONTAINS THE ERROR. 
  NUMBER...   IF CARRY CLEAR, THEN THE A
CCUMULATOR.   CONTAINS:..       0 -- FIN
ISHED, EVERYTHING A-OK,.            GO T
O NEXT "SENTENCE"...       1 -- FINISHED
, BUT IF ANY MORE.            NOUNS CAN 
BE PASSED, THEN.            RE-RUN PROGR
AM.            (USED BY RM, ETC, TO ACT.
             ON MULTIPLE FILES).
C64 Preview

> CLICK IMAGE PREVIEW FOR FULL MODAL