1 /* ------------------------------------------------------------------------- */
2 /* Header file for Inform: Z-machine ("Infocom" format) compiler */
4 /* Copyright (c) Graham Nelson 1993 - 2018 */
6 /* This file is part of Inform. */
8 /* Inform is free software: you can redistribute it and/or modify */
9 /* it under the terms of the GNU General Public License as published by */
10 /* the Free Software Foundation, either version 3 of the License, or */
11 /* (at your option) any later version. */
13 /* Inform is distributed in the hope that it will be useful, */
14 /* but WITHOUT ANY WARRANTY; without even the implied warranty of */
15 /* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the */
16 /* GNU General Public License for more details. */
18 /* You should have received a copy of the GNU General Public License */
19 /* along with Inform. If not, see https://gnu.org/licenses/ */
21 /* *** To compile this program in one of the existing ports, you must */
22 /* at least change the machine definition (on the next page). */
23 /* In most cases no other work will be needed. *** */
27 /* Machine/host OS definitions (in alphabetical order) */
28 /* Default definitions */
29 /* Standard ANSI inclusions, macro definitions, structures */
30 /* Definitions of internal code numbers */
31 /* Extern declarations for linkage (in alphabetical order of file) */
33 /* ------------------------------------------------------------------------- */
35 #define RELEASE_DATE "28th June 2018"
36 #define RELEASE_NUMBER 1634
37 #define GLULX_RELEASE_NUMBER 38
38 #define MODULE_VERSION_NUMBER 1
39 #define VNUMBER RELEASE_NUMBER
41 /* N indicates an intermediate release for Inform 7 */
42 /*#define RELEASE_SUFFIX "N"*/
44 /* ------------------------------------------------------------------------- */
45 /* Our host machine or OS for today is... */
47 /* [ Inform should compile (possibly with warnings) and work safely */
50 /* #define AMIGA - for the Commodore Amiga under SAS/C */
51 /* #define ARCHIMEDES - for Acorn RISC OS machines under Norcroft C */
52 /* #define ATARIST - for the Atari ST */
53 /* #define BEOS - for the BeBox */
54 /* #define LINUX - for Linux under gcc (essentially as Unix) */
55 /* #define MACOS - for the Apple Mac with OS X (another Unix) */
56 /* #define MAC_CLASSIC - for the Apple Mac under Think C or Codewarrior */
57 /* #define MAC_MPW - for MPW under Codewarrior (and maybe Think C) */
58 /* #define OS2 - for OS/2 32-bit mode under IBM's C Set++ */
59 /* #define PC - for 386+ IBM PCs, eg. Microsoft Visual C/C++ */
60 /* #define PC_QUICKC - for small IBM PCs under QuickC */
61 /* #define PC_WIN32 - for Borland C++ or Microsoft Visual C++ */
62 /* #define UNIX - for Unix under gcc (or big IBM PC under djgpp) */
63 /* #define VMS - for VAX or ALPHA under DEC C, but not VAX C */
65 /* In most cases executables are already available at */
66 /* http://www.ifarchive.org/, and these are sometimes enhanced with */
67 /* e.g. windowed interfaces whose source is not archived with the */
68 /* main Inform source.] */
70 /* (If no machine is defined, then cautious #defines will be made. In */
71 /* most cases, porting to a new machine is a matter of carefully filling */
72 /* out a block of definitions like those below.) */
73 /* ------------------------------------------------------------------------- */
77 /* ------------------------------------------------------------------------- */
78 /* The first task is to include the ANSI header files, and typedef */
79 /* suitable 32-bit integer types. */
80 /* ------------------------------------------------------------------------- */
92 #if SCHAR_MAX >= 0x7FFFFFFFL && SCHAR_MIN <= -0x7FFFFFFFL
93 typedef signed char int32;
94 typedef unsigned char uint32;
95 #elif SHRT_MAX >= 0x7FFFFFFFL && SHRT_MIN <= -0x7FFFFFFFL
96 typedef signed short int int32;
97 typedef unsigned short int uint32;
98 #elif INT_MAX >= 0x7FFFFFFFL && INT_MIN <= -0x7FFFFFFFL
99 typedef signed int int32;
100 typedef unsigned int uint32;
101 #elif LONG_MAX >= 0x7FFFFFFFL && LONG_MIN <= -0x7FFFFFFFL
102 typedef signed long int int32;
103 typedef unsigned long int uint32;
105 #error No type large enough to support 32-bit integers.
108 /* VAX C does not provide these limit constants, contrary to ANSI */
110 typedef unsigned int uint32;
113 /* ------------------------------------------------------------------------- */
114 /* The next part of this file contains blocks of definitions, one for */
115 /* each port, of machine or OS-dependent constants needed by Inform. */
117 /* 1. MACHINE_STRING should be set to the name of the machine or OS. */
119 /* 2. Some miscellaneous #define options (set if the constant is */
120 /* defined, otherwise not set): */
122 /* USE_TEMPORARY_FILES - use scratch files for workspace, not memory, */
124 /* PROMPT_INPUT - prompt input (don't use Unix-style command line) */
125 /* TIME_UNAVAILABLE - don't use ANSI time routines to work out today's */
127 /* CHAR_IS_UNSIGNED - if on your compiler the type "char" is unsigned */
128 /* by default, you should define this */
129 /* HAS_REALPATH - the POSIX realpath() function is available to */
130 /* find the absolute path to a file */
132 /* 3. An estimate of the typical amount of memory likely to be free */
133 /* should be given in DEFAULT_MEMORY_SIZE. */
134 /* For most modern machines, HUGE_SIZE is the appropriate setting, but */
135 /* some older micros may benefit from SMALL_SIZE. */
136 /* ------------------------------------------------------------------------- */
142 /* ------------------------------------------------------------------------- */
143 /* 4. Filenaming definitions: */
145 /* It's assumed that the host OS has the concept of subdirectories and */
146 /* has "pathnames", that is, filenames giving a chain of subdirectories */
147 /* divided by the FN_SEP (filename separator) character: e.g. for Unix */
148 /* FN_SEP is defined below as '/' and a typical name is */
149 /* "users/graham/jigsaw.z5". */
150 /* White space is not allowed in filenames, and nor is the special */
151 /* character FN_ALT, which unless defined here will be a comma and will */
152 /* be used to separate alternative locations in a path variable. */
154 /* If NO_FILE_EXTENSIONS is undefined then the OS allows "file extensions" */
155 /* of 1 to 3 alphanumeric characters like ".txt" (for text files), ".z5" */
156 /* (for game files), etc., to indicate the file's type (and, crucially, */
157 /* regards the same filename but with different extensions -- e.g., */
158 /* "frog.amp" and "frog.lil" -- as being different names). */
159 /* (The file extensions defined below are widely accepted, so please use */
160 /* them unless there's a good reason why not.) */
162 /* You should then define STANDARD_DIRECTORIES (you can define it anyway) */
163 /* in which case Inform will expect by default that files are sorted out */
164 /* by being put into suitable directories (e.g., a "games" directory for */
167 /* If it's convenient for your port you can alter the detailed definitions */
168 /* which these broad settings make. Be careful if NO_FILE_EXTENSIONS */
169 /* is set without STANDARD_DIRECTORIES, as then Inform may */
170 /* overwrite its source with object code. */
172 /* 5. Filenames (or code related to filenames) for the three temporary */
173 /* files. These only exist during compilation (and only if -F1 is set). */
174 /* Temporary_Name is the body of a filename to use */
175 /* (if you don't set this, it becomes "Inftemp") and Temporary_Directory */
176 /* is the directory path for the files to go in (which can be altered on */
177 /* the command line). On some multi-tasking OSs these filenames ought to */
178 /* include a number uniquely identifying the process: to indicate this, */
179 /* define INCLUDE_TASK_ID and provide some code... */
181 /* #define INCLUDE_TASK_ID */
182 /* #ifdef INFORM_FILE */
183 /* static int32 unique_task_id(void) */
184 /* { ...some code returning your task ID... */
188 /* 6. Any other definitions specific to the OS or machine. */
189 /* (In particular DEFAULT_ERROR_FORMAT is 0 on most machines and 1 on PCs; */
190 /* it controls the style of error messages, which is important for some */
191 /* error-throwback debugging tools.) */
192 /* ------------------------------------------------------------------------- */
194 /* ========================================================================= */
195 /* The blocks now follow in alphabetical order. */
196 /* ------------------------------------------------------------------------- */
198 /* ------------------------------------------------------------------------- */
201 #define MACHINE_STRING "Amiga"
203 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
207 #define __USE_SYSBASE
208 #include <proto/exec.h>
209 #define INCLUDE_TASK_ID
210 #define Temporary_Directory "T:"
211 #ifdef MAIN_INFORM_FILE
212 static int32 unique_task_id(void)
213 { return (int32)FindTask(NULL);
217 /* ------------------------------------------------------------------------- */
218 /* ARCHIMEDES block: Acorn/RISC OS settings */
219 /* ------------------------------------------------------------------------- */
222 #define MACHINE_STRING "RISC OS"
224 #define CHAR_IS_UNSIGNED
226 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
229 #define STANDARD_DIRECTORIES
230 #define NO_FILE_EXTENSIONS
231 #define Source_Directory "inform"
232 #define ICL_Directory "ICL"
234 #define ENABLE_TEMPORARY_PATH
235 #define Temporary_Directory "ram:"
237 #define ARC_THROWBACK
239 /* ------------------------------------------------------------------------- */
241 /* ------------------------------------------------------------------------- */
244 #define MACHINE_STRING "Atari ST"
246 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
251 #define Temporary_Directory "/tmp"
252 #define INCLUDE_TASK_ID
253 #ifdef MAIN_INFORM_FILE
254 static int32 unique_task_id(void)
255 { return (int32)getpid();
260 /* ------------------------------------------------------------------------- */
262 /* ------------------------------------------------------------------------- */
265 #define MACHINE_STRING "BeOS"
267 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
270 #define FILE_EXTENSIONS
272 #define Temporary_Directory "/tmp"
274 /* ------------------------------------------------------------------------- */
276 /* ------------------------------------------------------------------------- */
279 #define MACHINE_STRING "Linux"
283 #define DEFAULT_MEMORY_SIZE HUGE_SIZE
287 #define Temporary_Directory "/tmp"
291 /* ------------------------------------------------------------------------- */
292 /* Macintosh block */
293 /* ------------------------------------------------------------------------- */
301 #define MACHINE_STRING "Macintosh Programmer's Workshop"
303 #define MACHINE_STRING "Macintosh"
307 #define EXTERNAL_SHELL
315 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
319 #define Include_Extension ".h"
323 #include "TB Inform.h"
326 #include <CursorCtl.h>
327 #define DEFAULT_ERROR_FORMAT 2
330 /* ------------------------------------------------------------------------- */
332 /* ------------------------------------------------------------------------- */
335 #define MACHINE_STRING "OS/2"
337 #define CHAR_IS_UNSIGNED
339 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
343 /* ------------------------------------------------------------------------- */
345 /* ------------------------------------------------------------------------- */
348 #define MACHINE_STRING "MacOS"
352 #define DEFAULT_MEMORY_SIZE HUGE_SIZE
356 #define Temporary_Directory "/tmp"
357 #define INCLUDE_TASK_ID
358 #define _POSIX_C_SOURCE 199506L
359 #define _XOPEN_SOURCE 500
360 #ifdef MAIN_INFORM_FILE
361 #include <sys/types.h>
363 static int32 unique_task_id(void)
364 { return (int32)getpid();
370 /* ------------------------------------------------------------------------- */
371 /* PC and PC_QUICKC block */
372 /* ------------------------------------------------------------------------- */
379 #define MACHINE_STRING "PC"
381 #define USE_TEMPORARY_FILES
384 #define DEFAULT_MEMORY_SIZE SMALL_SIZE
386 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
391 #define DEFAULT_ERROR_FORMAT 1
393 /* ------------------------------------------------------------------------- */
395 /* ------------------------------------------------------------------------- */
398 #define MACHINE_STRING "Win32"
402 #define DEFAULT_MEMORY_SIZE HUGE_SIZE
406 #define DEFAULT_ERROR_FORMAT 1
408 #ifdef _MSC_VER /* Microsoft Visual C++ */
409 #define snprintf _snprintf
411 #define isinf(x) (!_isnan(x) && !_finite(x))
414 /* ------------------------------------------------------------------------- */
416 /* ------------------------------------------------------------------------- */
419 #ifndef MACHINE_STRING
420 #define MACHINE_STRING "Unix"
425 #define DEFAULT_MEMORY_SIZE HUGE_SIZE
430 #define Temporary_Directory "/tmp"
431 #define INCLUDE_TASK_ID
432 #ifdef MAIN_INFORM_FILE
434 static int32 unique_task_id(void)
435 { return (int32)getpid();
439 /* ------------------------------------------------------------------------- */
440 /* VMS (Dec VAX and Alpha) block */
441 /* ------------------------------------------------------------------------- */
449 #define MACHINE_STRING "Alpha/VMS"
451 #define MACHINE_STRING "VAX/VMS"
454 #define CHAR_IS_UNSIGNED
456 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
459 #define Code_Extension ".zip"
460 #define V4Code_Extension ".zip"
461 #define V5Code_Extension ".zip"
462 #define V6Code_Extension ".zip"
463 #define V7Code_Extension ".zip"
464 #define V8Code_Extension ".zip"
466 /* ========================================================================= */
467 /* Default settings: */
468 /* ------------------------------------------------------------------------- */
470 #ifndef NO_FILE_EXTENSIONS
471 #define FILE_EXTENSIONS
474 #ifndef Transcript_File
475 #ifdef FILE_EXTENSIONS
476 #define Transcript_File "gametext.txt"
478 #define Transcript_File "gametext"
481 #ifndef Debugging_File
482 #ifdef FILE_EXTENSIONS
483 #define Debugging_File "gameinfo.dbg"
485 #define Debugging_File "gamedebug"
489 #ifdef FILE_EXTENSIONS
490 #ifndef Source_Extension
491 #define Source_Extension ".inf"
493 #ifndef Include_Extension
494 #define Include_Extension ".h"
496 #ifndef Code_Extension
497 #define Code_Extension ".z3"
499 #ifndef V4Code_Extension
500 #define V4Code_Extension ".z4"
502 #ifndef V5Code_Extension
503 #define V5Code_Extension ".z5"
505 #ifndef V6Code_Extension
506 #define V6Code_Extension ".z6"
508 #ifndef V7Code_Extension
509 #define V7Code_Extension ".z7"
511 #ifndef V8Code_Extension
512 #define V8Code_Extension ".z8"
514 #ifndef GlulxCode_Extension
515 #define GlulxCode_Extension ".ulx"
517 #ifndef Module_Extension
518 #define Module_Extension ".m5"
520 #ifndef ICL_Extension
521 #define ICL_Extension ".icl"
526 #define Source_Extension ""
527 #define Include_Extension ""
528 #define Code_Extension ""
529 #define V4Code_Extension ""
530 #define V5Code_Extension ""
531 #define V6Code_Extension ""
532 #define V7Code_Extension ""
533 #define V8Code_Extension ""
534 #define GlulxCode_Extension ""
535 #define Module_Extension ""
536 #define ICL_Extension ""
539 #ifdef STANDARD_DIRECTORIES
540 #ifndef Source_Directory
541 #define Source_Directory "source"
543 #ifndef Include_Directory
544 #define Include_Directory "library"
546 #ifndef Code_Directory
547 #define Code_Directory "games"
549 #ifndef Module_Directory
550 #define Module_Directory "modules"
552 #ifndef Temporary_Directory
553 #define Temporary_Directory ""
555 #ifndef ICL_Directory
556 #define ICL_Directory ""
561 #ifndef Source_Directory
562 #define Source_Directory ""
564 #ifndef Include_Directory
565 #define Include_Directory ""
567 #ifndef Code_Directory
568 #define Code_Directory ""
570 #ifndef Module_Directory
571 #define Module_Directory ""
573 #ifndef Temporary_Directory
574 #define Temporary_Directory ""
576 #ifndef ICL_Directory
577 #define ICL_Directory ""
593 #ifndef Temporary_File
594 #define Temporary_File "Inftemp"
597 #ifndef DEFAULT_ERROR_FORMAT
598 #define DEFAULT_ERROR_FORMAT 0
601 #ifndef DEFAULT_MEMORY_SIZE
602 #define DEFAULT_MEMORY_SIZE LARGE_SIZE
605 #ifndef CHAR_IS_UNSIGNED
606 typedef unsigned char uchar;
611 #if defined(__GNUC__) || defined(__clang__)
612 #define NORETURN __attribute__((__noreturn__))
613 #endif /* defined(__GNUC__) || defined(__clang__) */
619 /* ------------------------------------------------------------------------- */
620 /* A macro (rather than constant) definition: */
621 /* ------------------------------------------------------------------------- */
624 void _huge * halloc(long, size_t);
626 #define subtract_pointers(p1,p2) (long)((char _huge *)p1-(char _huge *)p2)
628 #define subtract_pointers(p1,p2) (((char *) p1)-((char *) p2))
631 /* ------------------------------------------------------------------------- */
632 /* SEEK_SET is a constant which should be defined in the ANSI header files */
633 /* but which is not present in some implementations: it's used as a */
634 /* parameter for "fseek", defined in "stdio". In pre-ANSI C, the value */
635 /* 0 was used as a parameter instead, hence the definition below. */
636 /* ------------------------------------------------------------------------- */
642 /* ------------------------------------------------------------------------- */
643 /* A large block of #define'd constant values follows. */
644 /* ------------------------------------------------------------------------- */
649 /* These checked the glulx_mode global during development, but are no
651 #define ASSERT_ZCODE() (0)
652 #define ASSERT_GLULX() (0)
655 #define ReadInt32(ptr) \
656 ( (((int32)(((uchar *)(ptr))[0])) << 24) \
657 | (((int32)(((uchar *)(ptr))[1])) << 16) \
658 | (((int32)(((uchar *)(ptr))[2])) << 8) \
659 | (((int32)(((uchar *)(ptr))[3])) ) )
661 #define ReadInt16(ptr) \
662 ( (((int32)(((uchar *)(ptr))[0])) << 8) \
663 | (((int32)(((uchar *)(ptr))[1])) ) )
665 #define WriteInt32(ptr, val) \
666 ((ptr)[0] = (uchar)(((int32)(val)) >> 24), \
667 (ptr)[1] = (uchar)(((int32)(val)) >> 16), \
668 (ptr)[2] = (uchar)(((int32)(val)) >> 8), \
669 (ptr)[3] = (uchar)(((int32)(val)) ) )
671 #define WriteInt16(ptr, val) \
672 ((ptr)[0] = (uchar)(((int32)(val)) >> 8), \
673 (ptr)[1] = (uchar)(((int32)(val)) ) )
675 /* ------------------------------------------------------------------------- */
676 /* If your compiler doesn't recognise \t, and you use ASCII, you could */
677 /* define T_C as (char) 9; failing that, it _must_ be defined as ' ' */
678 /* (space) and is _not_ allowed to be 0 or any recognisable character. */
679 /* ------------------------------------------------------------------------- */
681 #define TAB_CHARACTER '\t'
683 /* ------------------------------------------------------------------------- */
685 /* ------------------------------------------------------------------------- */
687 #define MAX_ERRORS 100
688 #define MAX_IDENTIFIER_LENGTH 32
689 #define MAX_ABBREV_LENGTH 64
690 #define MAX_DICT_WORD_SIZE 40
691 #define MAX_DICT_WORD_BYTES (40*4)
692 #define MAX_NUM_ATTR_BYTES 39
693 #define MAX_VERB_WORD_SIZE 120
695 #define VENEER_CONSTRAINT_ON_CLASSES_Z 256
696 #define VENEER_CONSTRAINT_ON_IP_TABLE_SIZE_Z 128
697 #define VENEER_CONSTRAINT_ON_CLASSES_G 32768
698 #define VENEER_CONSTRAINT_ON_IP_TABLE_SIZE_G 32768
699 #define VENEER_CONSTRAINT_ON_CLASSES \
700 (glulx_mode ? VENEER_CONSTRAINT_ON_CLASSES_G \
701 : VENEER_CONSTRAINT_ON_CLASSES_Z)
702 #define VENEER_CONSTRAINT_ON_IP_TABLE_SIZE \
703 (glulx_mode ? VENEER_CONSTRAINT_ON_IP_TABLE_SIZE_G \
704 : VENEER_CONSTRAINT_ON_IP_TABLE_SIZE_Z)
706 #define GLULX_HEADER_SIZE 36
707 /* Number of bytes in the header. */
708 #define GLULX_STATIC_ROM_SIZE 24
709 /* Number of bytes in the Inform-specific block right after the header. */
710 #define GPAGESIZE 256
711 /* All Glulx memory boundaries must be multiples of GPAGESIZE. */
713 /* ------------------------------------------------------------------------- */
714 /* Structure definitions (there are a few others local to files) */
715 /* ------------------------------------------------------------------------- */
717 typedef struct assembly_operand_t
720 int symtype; /* 6.30 */
721 int symflags; /* 6.30 */
725 #define INITAOTV(aop, typ, val) ((aop)->type=(typ), (aop)->value=(val), (aop)->marker=0, (aop)->symtype=0, (aop)->symflags=0)
726 #define INITAOT(aop, typ) INITAOTV(aop, typ, 0)
727 #define INITAO(aop) INITAOTV(aop, 0, 0)
729 #define MAX_LINES_PER_VERB 32
730 typedef struct verbt {
732 int l[MAX_LINES_PER_VERB];
735 typedef struct prop {
737 assembly_operand ao[32];
740 /* Only one of this object. */
741 typedef struct fpropt {
747 typedef struct objecttz {
749 int parent, next, child;
753 typedef struct propg {
761 /* Only one of this object. */
762 typedef struct fproptg {
763 uchar atts[MAX_NUM_ATTR_BYTES];
767 assembly_operand *propdata;
771 typedef struct objecttg {
772 /* attributes are stored in a separate array */
774 int32 parent, next, child;
779 typedef struct maybe_file_position_S
782 } maybe_file_position;
784 typedef struct debug_location_s
786 int32 beginning_byte_index;
787 int32 end_byte_index;
788 int32 beginning_line_number;
789 int32 end_line_number;
790 int32 beginning_character_number;
791 int32 end_character_number;
792 int32 orig_file_index;
793 int32 orig_beg_line_number;
794 int32 orig_beg_char_number;
795 /* We only track the beginning #origsource location, not the end. */
798 typedef struct debug_locations_s
799 { debug_location location;
800 struct debug_locations_s *next;
804 typedef struct brief_location_s
807 int32 orig_file_index;
808 int32 orig_line_number;
811 typedef struct debug_location_beginning_s
812 { debug_locations *head;
813 int32 beginning_byte_index;
814 int32 beginning_line_number;
815 int32 beginning_character_number;
816 int32 orig_file_index;
817 int32 orig_beg_line_number;
818 int32 orig_beg_char_number;
819 } debug_location_beginning;
821 typedef struct keyword_group_s
822 { char *keywords[120];
823 int change_token_type;
828 typedef struct token_data_s
830 int32 value; /* ###-long */
832 int symtype; /* 6.30 */
833 int symflags; /* 6.30 */
835 debug_location location;
838 typedef struct FileId_s /* Source code file identifier: */
839 { char *filename; /* The filename (after translation) */
840 FILE *handle; /* Handle of file (when open), or
842 int is_input; /* Is this a source file that we are
843 parsing? If not, this is an
844 origsource filename (and handle
848 typedef struct ErrorPosition_s
859 /* A memory block can hold at most ALLOC_CHUNK_SIZE * 72: */
861 extern int ALLOC_CHUNK_SIZE;
863 typedef struct memory_block_s
870 /* This serves for both Z-code and Glulx instructions. Glulx doesn't use
871 the text, store_variable_number, branch_label_number, or branch_flag
873 typedef struct assembly_instruction_t
874 { int internal_number;
875 int store_variable_number;
876 int32 branch_label_number;
880 assembly_operand operand[8];
881 } assembly_instruction;
883 typedef struct expression_tree_node_s
885 /* Data used in tree construction */
888 int operator_number; /* Only meaningful for non-leaves */
889 assembly_operand value; /* Only meaningful for leaves */
891 /* Attributes synthesised during code generation */
893 int must_produce_value; /* e.g. FALSE in a void context */
895 int label_after; /* -1, or "put this label after code" */
896 int to_expression; /* TRUE if a condition used as numeric val */
897 int true_label; /* On condition "true", jump to this (or keep
899 int false_label; /* Likewise if the condition is "false". */
901 } expression_tree_node;
903 typedef struct operator_s
904 { int precedence; /* Level 0 to 13 (13 is highest) */
905 int token_type; /* Lexical token type */
906 int token_value; /* Lexical token value */
907 int usage; /* Infix (IN_U), prefix or postfix */
908 int associativity; /* Left (L_A), right (R_A)
909 or 0 for "it is an error to
910 implicitly associate this" */
911 int requires_lvalue; /* TRUE if the first operand must
912 be an "lvalue" (the name of some
913 storage object, such as a variable
914 or an array entry) */
915 int opcode_number_z; /* Translation number (see below) */
916 int opcode_number_g; /* Translation number (see below) */
917 int side_effect; /* TRUE if evaluating the operator
918 has potential side-effects in
919 terms of changing the Z-machine */
920 int negation; /* 0 for an unconditional operator,
921 otherwise the negation operator */
922 char *description; /* Text describing the operator
923 for error messages and tracing */
926 /* The translation number of an operator is as follows:
929 an internal opcode number if the operator can be translated
930 directly to a single Z-machine opcode;
931 400+n if it can be translated to branch opcode n;
932 800+n if to the negated form of branch opcode n;
933 (using n = 200, 201 for two conditions requiring special
937 an internal opcode number if the operator can be translated
938 directly to a single Glulx opcode;
939 FIRST_CC to LAST_CC if it is a condition;
942 /* ------------------------------------------------------------------------- */
943 /* Assembly operand types. */
944 /* ------------------------------------------------------------------------- */
946 /* For Z-machine... */
948 #define LONG_CONSTANT_OT 0 /* General constant */
949 #define SHORT_CONSTANT_OT 1 /* Constant in range 0 to 255 */
950 #define VARIABLE_OT 2 /* Variable (global, local or sp) */
951 #define OMITTED_OT 3 /* Value used in type field to indicate
952 that no operand is supplied */
953 #define EXPRESSION_OT 4 /* Meaning: to determine this value, run code
954 equivalent to the expression tree whose
955 root node-number is the value given */
959 /* #define OMITTED_OT 3 */ /* Same as above */
960 /* #define EXPRESSION_OT 4 */ /* Same as above */
961 #define CONSTANT_OT 5 /* Four-byte constant */
962 #define HALFCONSTANT_OT 6 /* Two-byte constant */
963 #define BYTECONSTANT_OT 7 /* One-byte constant */
964 #define ZEROCONSTANT_OT 8 /* Constant zero (no bytes of data) */
965 #define SYSFUN_OT 9 /* System function value */
966 #define DEREFERENCE_OT 10 /* Value at this address */
967 #define GLOBALVAR_OT 11 /* Global variable */
968 #define LOCALVAR_OT 12 /* Local variable or sp */
970 /* ------------------------------------------------------------------------- */
971 /* Internal numbers representing assemble-able Z-opcodes */
972 /* ------------------------------------------------------------------------- */
983 #define test_attr_zc 9
984 #define set_attr_zc 10
985 #define clear_attr_zc 11
987 #define insert_obj_zc 13
990 #define get_prop_zc 16
991 #define get_prop_addr_zc 17
992 #define get_next_prop_zc 18
1000 #define storeb_zc 26
1001 #define put_prop_zc 27
1003 #define print_char_zc 29
1004 #define print_num_zc 30
1005 #define random_zc 31
1008 #define split_window_zc 34
1009 #define set_window_zc 35
1010 #define output_stream_zc 36
1011 #define input_stream_zc 37
1012 #define sound_effect_zc 38
1014 #define get_sibling_zc 40
1015 #define get_child_zc 41
1016 #define get_parent_zc 42
1017 #define get_prop_len_zc 43
1020 #define print_addr_zc 46
1021 #define remove_obj_zc 47
1022 #define print_obj_zc 48
1025 #define print_paddr_zc 51
1029 #define rfalse_zc 55
1031 #define print_ret_zc 57
1034 #define restore_zc 60
1035 #define restart_zc 61
1036 #define ret_popped_zc 62
1039 #define new_line_zc 65
1040 #define show_status_zc 66
1041 #define verify_zc 67
1042 #define call_2s_zc 68
1043 #define call_vs_zc 69
1045 #define call_vs2_zc 71
1046 #define erase_window_zc 72
1047 #define erase_line_zc 73
1048 #define set_cursor_zc 74
1049 #define get_cursor_zc 75
1050 #define set_text_style_zc 76
1051 #define buffer_mode_zc 77
1052 #define read_char_zc 78
1053 #define scan_table_zc 79
1054 #define call_1s_zc 80
1055 #define call_2n_zc 81
1056 #define set_colour_zc 82
1058 #define call_vn_zc 84
1059 #define call_vn2_zc 85
1060 #define tokenise_zc 86
1061 #define encode_text_zc 87
1062 #define copy_table_zc 88
1063 #define print_table_zc 89
1064 #define check_arg_count_zc 90
1065 #define call_1n_zc 91
1067 #define piracy_zc 93
1068 #define log_shift_zc 94
1069 #define art_shift_zc 95
1070 #define set_font_zc 96
1071 #define save_undo_zc 97
1072 #define restore_undo_zc 98
1073 #define draw_picture_zc 99
1074 #define picture_data_zc 100
1075 #define erase_picture_zc 101
1076 #define set_margins_zc 102
1077 #define move_window_zc 103
1078 #define window_size_zc 104
1079 #define window_style_zc 105
1080 #define get_wind_prop_zc 106
1081 #define scroll_window_zc 107
1082 #define pop_stack_zc 108
1083 #define read_mouse_zc 109
1084 #define mouse_window_zc 110
1085 #define push_stack_zc 111
1086 #define put_wind_prop_zc 112
1087 #define print_form_zc 113
1088 #define make_menu_zc 114
1089 #define picture_table_zc 115
1090 #define print_unicode_zc 116
1091 #define check_unicode_zc 117
1094 /* ------------------------------------------------------------------------- */
1095 /* Internal numbers representing assemble-able Glulx opcodes */
1096 /* ------------------------------------------------------------------------- */
1108 #define bitnot_gc 10
1109 #define shiftl_gc 11
1110 #define sshiftr_gc 12
1111 #define ushiftr_gc 13
1126 #define return_gc 28
1129 #define tailcall_gc 31
1136 #define aloads_gc 38
1137 #define aloadb_gc 39
1138 #define aloadbit_gc 40
1139 #define astore_gc 41
1140 #define astores_gc 42
1141 #define astoreb_gc 43
1142 #define astorebit_gc 44
1143 #define stkcount_gc 45
1144 #define stkpeek_gc 46
1145 #define stkswap_gc 47
1146 #define stkroll_gc 48
1147 #define stkcopy_gc 49
1148 #define streamchar_gc 50
1149 #define streamnum_gc 51
1150 #define streamstr_gc 52
1151 #define gestalt_gc 53
1152 #define debugtrap_gc 54
1153 #define getmemsize_gc 55
1154 #define setmemsize_gc 56
1155 #define jumpabs_gc 57
1156 #define random_gc 58
1157 #define setrandom_gc 59
1159 #define verify_gc 61
1160 #define restart_gc 62
1162 #define restore_gc 64
1163 #define saveundo_gc 65
1164 #define restoreundo_gc 66
1165 #define protect_gc 67
1167 #define getstringtbl_gc 69
1168 #define setstringtbl_gc 70
1169 #define getiosys_gc 71
1170 #define setiosys_gc 72
1171 #define linearsearch_gc 73
1172 #define binarysearch_gc 74
1173 #define linkedsearch_gc 75
1175 #define callfi_gc 77
1176 #define callfii_gc 78
1177 #define callfiii_gc 79
1178 #define streamunichar_gc 80
1181 #define malloc_gc 83
1183 #define accelfunc_gc 85
1184 #define accelparam_gc 86
1185 #define numtof_gc 87
1186 #define ftonumz_gc 88
1187 #define ftonumn_gc 89
1205 #define atan2_gc 107
1212 #define jisnan_gc 114
1213 #define jisinf_gc 115
1215 /* ------------------------------------------------------------------------- */
1216 /* Index numbers into the keyword group "opcode_macros_g" (see "lexer.c") */
1217 /* ------------------------------------------------------------------------- */
1223 #define SYMBOL_TT 0 /* value = index in symbol table */
1224 #define NUMBER_TT 1 /* value = the number */
1225 #define DQ_TT 2 /* no value */
1226 #define SQ_TT 3 /* no value */
1227 #define SEP_TT 4 /* value = the _SEP code */
1228 #define EOF_TT 5 /* no value */
1230 #define STATEMENT_TT 100 /* a statement keyword */
1231 #define SEGMENT_MARKER_TT 101 /* with/has/class etc. */
1232 #define DIRECTIVE_TT 102 /* a directive keyword */
1233 #define CND_TT 103 /* in/has/etc. */
1234 #define SYSFUN_TT 105 /* built-in function */
1235 #define LOCAL_VARIABLE_TT 106 /* local variable */
1236 #define OPCODE_NAME_TT 107 /* opcode name */
1237 #define MISC_KEYWORD_TT 108 /* keyword like "char" used in
1238 syntax for a statement */
1239 #define DIR_KEYWORD_TT 109 /* keyword like "meta" used in
1240 syntax for a directive */
1241 #define TRACE_KEYWORD_TT 110 /* keyword used in debugging */
1242 #define SYSTEM_CONSTANT_TT 111 /* such as "code_offset" */
1243 #define OPCODE_MACRO_TT 112 /* fake opcode for compatibility */
1245 #define OP_TT 200 /* value = operator no */
1246 #define ENDEXP_TT 201 /* no value */
1247 #define SUBOPEN_TT 202 /* ( used for subexpr */
1248 #define SUBCLOSE_TT 203 /* ) used to close subexp */
1249 #define LARGE_NUMBER_TT 204 /* constant not in range 0-255 */
1250 #define SMALL_NUMBER_TT 205 /* constant in range 0-255 */
1251 /* In Glulx, that's the range -0x8000 to 0x7fff instead. */
1252 #define VARIABLE_TT 206 /* variable name */
1253 #define DICTWORD_TT 207 /* literal 'word' */
1254 #define ACTION_TT 208 /* action name */
1256 #define VOID_CONTEXT 1
1257 #define CONDITION_CONTEXT 2
1258 #define CONSTANT_CONTEXT 3
1259 #define QUANTITY_CONTEXT 4
1260 #define ACTION_Q_CONTEXT 5
1261 #define ASSEMBLY_CONTEXT 6
1262 #define ARRAY_CONTEXT 7
1263 #define FORINIT_CONTEXT 8
1264 #define RETURN_Q_CONTEXT 9
1266 #define LOWEST_SYSTEM_VAR_NUMBER 249 /* globals 249 to 255 are used
1267 in compiled code (Z-code
1268 only; in Glulx, the range can
1271 /* ------------------------------------------------------------------------- */
1272 /* Symbol flag definitions (in no significant order) */
1273 /* ------------------------------------------------------------------------- */
1275 #define UNKNOWN_SFLAG 1
1276 #define REPLACE_SFLAG 2
1277 #define USED_SFLAG 4
1278 #define DEFCON_SFLAG 8
1279 #define STUB_SFLAG 16
1280 #define IMPORT_SFLAG 32
1281 #define EXPORT_SFLAG 64
1282 #define ALIASED_SFLAG 128
1284 #define CHANGE_SFLAG 256
1285 #define SYSTEM_SFLAG 512
1286 #define INSF_SFLAG 1024
1287 #define UERROR_SFLAG 2048
1288 #define ACTION_SFLAG 4096
1289 #define REDEFINABLE_SFLAG 8192
1290 #define STAR_SFLAG 16384
1292 /* ------------------------------------------------------------------------- */
1293 /* Symbol type definitions */
1294 /* ------------------------------------------------------------------------- */
1298 #define GLOBAL_VARIABLE_T 3
1300 #define CONSTANT_T 5
1301 #define ATTRIBUTE_T 6
1302 #define PROPERTY_T 7
1303 #define INDIVIDUAL_PROPERTY_T 8
1306 #define FAKE_ACTION_T 11
1308 /* ------------------------------------------------------------------------- */
1309 /* Statusline_flag values */
1310 /* ------------------------------------------------------------------------- */
1312 #define SCORE_STYLE 0
1313 #define TIME_STYLE 1
1315 /* ------------------------------------------------------------------------- */
1316 /* Inform keyword definitions */
1317 /* ------------------------------------------------------------------------- */
1319 /* Index numbers into the keyword group "directives" (see "lexer.c") */
1321 #define ABBREVIATE_CODE 0
1322 #define ARRAY_CODE 1
1323 #define ATTRIBUTE_CODE 2
1324 #define CLASS_CODE 3
1325 #define CONSTANT_CODE 4
1326 #define DEFAULT_CODE 5
1327 #define DICTIONARY_CODE 6
1329 #define ENDIF_CODE 8
1330 #define EXTEND_CODE 9
1331 #define FAKE_ACTION_CODE 10
1332 #define GLOBAL_CODE 11
1333 #define IFDEF_CODE 12
1334 #define IFNDEF_CODE 13
1335 #define IFNOT_CODE 14
1336 #define IFV3_CODE 15
1337 #define IFV5_CODE 16
1338 #define IFTRUE_CODE 17
1339 #define IFFALSE_CODE 18
1340 #define IMPORT_CODE 19
1341 #define INCLUDE_CODE 20
1342 #define LINK_CODE 21
1343 #define LOWSTRING_CODE 22
1344 #define MESSAGE_CODE 23
1345 #define NEARBY_CODE 24
1346 #define OBJECT_CODE 25
1347 #define ORIGSOURCE_CODE 26
1348 #define PROPERTY_CODE 27
1349 #define RELEASE_CODE 28
1350 #define REPLACE_CODE 29
1351 #define SERIAL_CODE 30
1352 #define SWITCHES_CODE 31
1353 #define STATUSLINE_CODE 32
1354 #define STUB_CODE 33
1355 #define SYSTEM_CODE 34
1356 #define TRACE_CODE 35
1357 #define UNDEF_CODE 36
1358 #define VERB_CODE 37
1359 #define VERSION_CODE 38
1360 #define ZCHARACTER_CODE 39
1362 #define OPENBLOCK_CODE 100
1363 #define CLOSEBLOCK_CODE 101
1365 /* Index numbers into the keyword group "statements" (see "lexer.c") */
1368 #define BREAK_CODE 1
1369 #define CONTINUE_CODE 2
1370 #define SDEFAULT_CODE 3
1377 #define INVERSION_CODE 10
1378 #define JUMP_CODE 11
1379 #define MOVE_CODE 12
1380 #define NEW_LINE_CODE 13
1381 #define OBJECTLOOP_CODE 14
1382 #define PRINT_CODE 15
1383 #define PRINT_RET_CODE 16
1384 #define QUIT_CODE 17
1385 #define READ_CODE 18
1386 #define REMOVE_CODE 19
1387 #define RESTORE_CODE 20
1388 #define RETURN_CODE 21
1389 #define RFALSE_CODE 22
1390 #define RTRUE_CODE 23
1391 #define SAVE_CODE 24
1392 #define SPACES_CODE 25
1393 #define STRING_CODE 26
1394 #define STYLE_CODE 27
1395 #define SWITCH_CODE 28
1396 #define UNTIL_CODE 29
1397 #define WHILE_CODE 30
1399 #define ASSIGNMENT_CODE 100
1400 #define FUNCTION_CODE 101
1402 /* Index numbers into the keyword group "conditions" (see "lexer.c") */
1405 #define HASNT_COND 1
1407 #define NOTIN_COND 3
1408 #define OFCLASS_COND 4
1410 #define PROVIDES_COND 6
1412 /* Index numbers into the keyword group "segment_markers" (see "lexer.c") */
1414 #define CLASS_SEGMENT 0
1415 #define HAS_SEGMENT 1
1416 #define PRIVATE_SEGMENT 2
1417 #define WITH_SEGMENT 3
1419 /* Index numbers into the keyword group "misc_keywords" (see "lexer.c") */
1426 #define CAP_THE_MK 5
1429 #define REVERSE_MK 8
1431 #define UNDERLINE_MK 10
1436 #define ADDRESS_MK 15
1437 #define STRING_MK 16
1438 #define OBJECT_MK 17
1441 #define PROPERTY_MK 20
1444 /* Index numbers into the keyword group "directive_keywords" (see "lexer.c") */
1448 #define ADDITIVE_DK 2
1454 #define MULTIHELD_DK 8
1455 #define MULTIEXCEPT_DK 9
1456 #define MULTIINSIDE_DK 10
1457 #define CREATURE_DK 11
1458 #define SPECIAL_DK 12
1459 #define NUMBER_DK 13
1462 #define REVERSE_DK 16
1465 #define REPLACE_DK 19
1468 #define STRING_DK 22
1470 #define BUFFER_DK 24
1472 #define INITIAL_DK 26
1473 #define INITSTR_DK 27
1475 #define PRIVATE_DK 29
1479 #define FATALERROR_DK 33
1480 #define WARNING_DK 34
1481 #define TERMINATING_DK 35
1483 /* Index numbers into the keyword group "trace_keywords" (see "lexer.c") */
1485 #define DICTIONARY_TK 0
1486 #define SYMBOLS_TK 1
1487 #define OBJECTS_TK 2
1489 #define ASSEMBLY_TK 4
1490 #define EXPRESSIONS_TK 5
1497 /* Index numbers into the keyword group "system_constants" (see "lexer.c") */
1499 #define NO_SYSTEM_CONSTANTS 62
1501 #define adjectives_table_SC 0
1502 #define actions_table_SC 1
1503 #define classes_table_SC 2
1504 #define identifiers_table_SC 3
1505 #define preactions_table_SC 4
1506 #define version_number_SC 5
1507 #define largest_object_SC 6
1508 #define strings_offset_SC 7
1509 #define code_offset_SC 8
1510 #define dict_par1_SC 9
1511 #define dict_par2_SC 10
1512 #define dict_par3_SC 11
1513 #define actual_largest_object_SC 12
1514 #define static_memory_offset_SC 13
1515 #define array_names_offset_SC 14
1516 #define readable_memory_offset_SC 15
1517 #define cpv__start_SC 16
1518 #define cpv__end_SC 17
1519 #define ipv__start_SC 18
1520 #define ipv__end_SC 19
1521 #define array__start_SC 20
1522 #define array__end_SC 21
1524 #define lowest_attribute_number_SC 22
1525 #define highest_attribute_number_SC 23
1526 #define attribute_names_array_SC 24
1528 #define lowest_property_number_SC 25
1529 #define highest_property_number_SC 26
1530 #define property_names_array_SC 27
1532 #define lowest_action_number_SC 28
1533 #define highest_action_number_SC 29
1534 #define action_names_array_SC 30
1536 #define lowest_fake_action_number_SC 31
1537 #define highest_fake_action_number_SC 32
1538 #define fake_action_names_array_SC 33
1540 #define lowest_routine_number_SC 34
1541 #define highest_routine_number_SC 35
1542 #define routines_array_SC 36
1543 #define routine_names_array_SC 37
1544 #define routine_flags_array_SC 38
1546 #define lowest_global_number_SC 39
1547 #define highest_global_number_SC 40
1548 #define globals_array_SC 41
1549 #define global_names_array_SC 42
1550 #define global_flags_array_SC 43
1552 #define lowest_array_number_SC 44
1553 #define highest_array_number_SC 45
1554 #define arrays_array_SC 46
1555 #define array_names_array_SC 47
1556 #define array_flags_array_SC 48
1558 #define lowest_constant_number_SC 49
1559 #define highest_constant_number_SC 50
1560 #define constants_array_SC 51
1561 #define constant_names_array_SC 52
1563 #define lowest_class_number_SC 53
1564 #define highest_class_number_SC 54
1565 #define class_objects_array_SC 55
1567 #define lowest_object_number_SC 56
1568 #define highest_object_number_SC 57
1570 #define oddeven_packing_SC 58
1572 #define grammar_table_SC 59 /* Glulx-only */
1573 #define dictionary_table_SC 60 /* Glulx-only */
1574 #define dynam_string_table_SC 61 /* Glulx-only */
1577 /* Index numbers into the keyword group "system_functions" (see "lexer.c") */
1579 #define NUMBER_SYSTEM_FUNCTIONS 12
1581 #define CHILD_SYSF 0
1582 #define CHILDREN_SYSF 1
1583 #define ELDER_SYSF 2
1584 #define ELDEST_SYSF 3
1585 #define INDIRECT_SYSF 4
1586 #define PARENT_SYSF 5
1587 #define RANDOM_SYSF 6
1588 #define SIBLING_SYSF 7
1589 #define YOUNGER_SYSF 8
1590 #define YOUNGEST_SYSF 9
1591 #define METACLASS_SYSF 10
1592 #define GLK_SYSF 11 /* Glulx-only */
1594 /* Index numbers into the operators group "separators" (see "lexer.c") */
1596 #define NUMBER_SEPARATORS 49
1599 #define DARROW_SEP 1
1605 #define DIVIDE_SEP 7
1606 #define REMAINDER_SEP 8
1608 #define ARTOR_SEP 10
1609 #define LOGAND_SEP 11
1610 #define ARTAND_SEP 12
1611 #define LOGNOT_SEP 13
1612 #define NOTEQUAL_SEP 14
1613 #define ARTNOT_SEP 15
1614 #define CONDEQUALS_SEP 16
1615 #define SETEQUALS_SEP 17
1617 #define GREATER_SEP 19
1620 #define OPENB_SEP 22
1621 #define CLOSEB_SEP 23
1622 #define COMMA_SEP 24
1623 #define PROPADD_SEP 25
1624 #define PROPNUM_SEP 26
1625 #define MPROPADD_SEP 27
1626 #define MPROPNUM_SEP 28
1627 #define MESSAGE_SEP 29
1628 #define PROPERTY_SEP 30
1629 #define SUPERCLASS_SEP 31
1630 #define COLON_SEP 32
1632 #define SEMICOLON_SEP 34
1633 #define OPEN_SQUARE_SEP 35
1634 #define CLOSE_SQUARE_SEP 36
1635 #define OPEN_BRACE_SEP 37
1636 #define CLOSE_BRACE_SEP 38
1637 #define DOLLAR_SEP 39
1638 #define NBRANCH_SEP 40
1639 #define BRANCH_SEP 41
1640 #define HASHADOLLAR_SEP 42
1641 #define HASHGDOLLAR_SEP 43
1642 #define HASHNDOLLAR_SEP 44
1643 #define HASHRDOLLAR_SEP 45
1644 #define HASHWDOLLAR_SEP 46
1645 #define HASHHASH_SEP 47
1648 #define UNARY_MINUS_SEP 100
1649 #define POST_INC_SEP 101
1650 #define POST_DEC_SEP 102
1652 /* ------------------------------------------------------------------------- */
1653 /* Internal numbers used to refer to operators (in expressions) */
1654 /* (must correspond to entries in the operators table in "express.c") */
1655 /* ------------------------------------------------------------------------- */
1657 #define NUM_OPERATORS 68
1667 #define SETEQUALS_OP 1
1673 #define NONZERO_OP 6
1674 #define CONDEQUALS_OP 7
1675 #define NOTEQUAL_OP 8
1677 #define GREATER_OP 10
1684 #define OFCLASS_OP 17
1685 #define PROVIDES_OP 18
1686 #define NOTOFCLASS_OP 19
1687 #define NOTPROVIDES_OP 20
1693 #define DIVIDE_OP 25
1694 #define REMAINDER_OP 26
1695 #define ARTAND_OP 27
1697 #define ARTNOT_OP 29
1699 #define DARROW_OP 31
1700 #define UNARY_MINUS_OP 32
1702 #define POST_INC_OP 34
1704 #define POST_DEC_OP 36
1705 #define PROP_ADD_OP 37
1706 #define PROP_NUM_OP 38
1707 #define MPROP_ADD_OP 39
1708 #define MPROP_NUM_OP 40
1710 #define MESSAGE_OP 42
1711 #define PROPERTY_OP 43
1712 #define SUPERCLASS_OP 44
1714 #define ARROW_SETEQUALS_OP 45
1715 #define DARROW_SETEQUALS_OP 46
1716 #define MESSAGE_SETEQUALS_OP 47
1717 #define PROPERTY_SETEQUALS_OP 48
1719 #define ARROW_INC_OP 49
1720 #define DARROW_INC_OP 50
1721 #define MESSAGE_INC_OP 51
1722 #define PROPERTY_INC_OP 52
1724 #define ARROW_DEC_OP 53
1725 #define DARROW_DEC_OP 54
1726 #define MESSAGE_DEC_OP 55
1727 #define PROPERTY_DEC_OP 56
1729 #define ARROW_POST_INC_OP 57
1730 #define DARROW_POST_INC_OP 58
1731 #define MESSAGE_POST_INC_OP 59
1732 #define PROPERTY_POST_INC_OP 60
1734 #define ARROW_POST_DEC_OP 61
1735 #define DARROW_POST_DEC_OP 62
1736 #define MESSAGE_POST_DEC_OP 63
1737 #define PROPERTY_POST_DEC_OP 64
1739 #define PROP_CALL_OP 65
1740 #define MESSAGE_CALL_OP 66
1742 #define PUSH_OP 67 /* Glulx only */
1744 /* ------------------------------------------------------------------------- */
1745 /* The five types of compiled array */
1746 /* ------------------------------------------------------------------------- */
1748 #define BYTE_ARRAY 0
1749 #define WORD_ARRAY 1
1750 #define STRING_ARRAY 2
1751 #define TABLE_ARRAY 3
1752 #define BUFFER_ARRAY 4
1754 /* ------------------------------------------------------------------------- */
1755 /* Internal numbers used to refer to veneer routines */
1756 /* (must correspond to entries in the table in "veneer.c") */
1757 /* ------------------------------------------------------------------------- */
1759 #define VENEER_ROUTINES 48
1761 #define Box__Routine_VR 0
1763 #define R_Process_VR 1
1765 #define InDefArt_VR 3
1766 #define CDefArt_VR 4
1767 #define CInDefArt_VR 5
1768 #define PrintShortName_VR 6
1769 #define EnglishNumber_VR 7
1770 #define Print__Pname_VR 8
1773 #define RV__Pr_VR 10
1774 #define CA__Pr_VR 11
1775 #define IB__Pr_VR 12
1776 #define IA__Pr_VR 13
1777 #define DB__Pr_VR 14
1778 #define DA__Pr_VR 15
1779 #define RA__Pr_VR 16
1780 #define RL__Pr_VR 17
1781 #define RA__Sc_VR 18
1782 #define OP__Pr_VR 19
1783 #define OC__Cl_VR 20
1785 #define Copy__Primitive_VR 21
1786 #define RT__Err_VR 22
1787 #define Z__Region_VR 23
1788 #define Unsigned__Compare_VR 24
1789 #define Metaclass_VR 25
1790 #define CP__Tab_VR 26
1791 #define Cl__Ms_VR 27
1792 #define RT__ChT_VR 28
1793 #define RT__ChR_VR 29
1794 #define RT__ChG_VR 30
1795 #define RT__ChGt_VR 31
1796 #define RT__ChPS_VR 32
1797 #define RT__ChPR_VR 33
1798 #define RT__TrPS_VR 34
1799 #define RT__ChLDB_VR 35
1800 #define RT__ChLDW_VR 36
1801 #define RT__ChSTB_VR 37
1802 #define RT__ChSTW_VR 38
1803 #define RT__ChPrintC_VR 39
1804 #define RT__ChPrintA_VR 40
1805 #define RT__ChPrintS_VR 41
1806 #define RT__ChPrintO_VR 42
1808 /* Glulx-only veneer routines */
1809 #define OB__Move_VR 43
1810 #define OB__Remove_VR 44
1811 #define Print__Addr_VR 45
1812 #define Glk__Wrap_VR 46
1813 #define Dynam__String_VR 47
1815 /* ------------------------------------------------------------------------- */
1816 /* Run-time-error numbers (must correspond with RT__Err code in veneer) */
1817 /* ------------------------------------------------------------------------- */
1821 #define PARENT_RTE 4
1822 #define ELDEST_RTE 5
1824 #define YOUNGER_RTE 7
1825 #define SIBLING_RTE 8
1826 #define CHILDREN_RTE 9
1827 #define YOUNGEST_RTE 10
1828 #define ELDER_RTE 11
1829 #define OBJECTLOOP_RTE 12
1830 #define OBJECTLOOP2_RTE 13
1832 #define REMOVE_RTE 15
1833 #define MOVE1_RTE 16
1834 #define MOVE2_RTE 17
1835 /* 18 = creating a loop in object tree */
1836 /* 19 = giving a non-existent attribute */
1837 #define DBYZERO_RTE 20
1838 #define PROP_ADD_RTE 21
1839 #define PROP_NUM_RTE 22
1840 #define PROPERTY_RTE 23
1841 /* 24 = reading with -> out of range */
1842 /* 25 = reading with --> out of range */
1843 /* 26 = writing with -> out of range */
1844 /* 27 = writing with --> out of range */
1845 #define ABOUNDS_RTE 28
1846 /* similarly 29, 30, 31 */
1847 #define OBJECTLOOP_BROKEN_RTE 32
1848 /* 33 = print (char) out of range */
1849 /* 34 = print (address) out of range */
1850 /* 35 = print (string) out of range */
1851 /* 36 = print (object) out of range */
1853 /* ------------------------------------------------------------------------- */
1854 /* Z-region areas (used to refer to module positions in markers) */
1855 /* ------------------------------------------------------------------------- */
1857 #define LOW_STRINGS_ZA 1
1858 #define PROP_DEFAULTS_ZA 2
1859 #define OBJECT_TREE_ZA 3
1861 #define CLASS_NUMBERS_ZA 5
1862 #define INDIVIDUAL_PROP_ZA 6
1863 #define DYNAMIC_ARRAY_ZA 7 /* Z-code only */
1864 #define GRAMMAR_ZA 8
1865 #define ACTIONS_ZA 9
1866 #define PREACTIONS_ZA 10
1867 #define ADJECTIVES_ZA 11
1868 #define DICTIONARY_ZA 12
1870 #define STATIC_STRINGS_ZA 14
1871 #define LINK_DATA_ZA 15
1873 #define SYMBOLS_ZA 16
1875 #define ARRAY_ZA 17 /* Glulx only */
1876 #define GLOBALVAR_ZA 18 /* Glulx only */
1878 /* ------------------------------------------------------------------------- */
1879 /* "Marker values", used for backpatching and linkage */
1880 /* ------------------------------------------------------------------------- */
1882 #define NULL_MV 0 /* Null */
1884 /* Marker values used in backpatch areas: */
1886 #define DWORD_MV 1 /* Dictionary word address */
1887 #define STRING_MV 2 /* Static string */
1888 #define INCON_MV 3 /* "Hardware" constant (table address) */
1889 #define IROUTINE_MV 4 /* Call to internal routine */
1890 #define VROUTINE_MV 5 /* Call to veneer routine */
1891 #define ARRAY_MV 6 /* Ref to internal array address */
1892 #define NO_OBJS_MV 7 /* Ref to number of game objects */
1893 #define INHERIT_MV 8 /* Inherited property value */
1894 #define INHERIT_INDIV_MV 9 /* Inherited indiv property value */
1895 #define MAIN_MV 10 /* "Main" routine */
1896 #define SYMBOL_MV 11 /* Forward ref to unassigned symbol */
1898 /* Additional marker values used in module backpatch areas: */
1899 /* (In Glulx, OBJECT_MV and VARIABLE_MV are used in backpatching, even
1900 without modules.) */
1902 #define VARIABLE_MV 12 /* Global variable */
1903 #define IDENT_MV 13 /* Property identifier number */
1904 #define INDIVPT_MV 14 /* Individual prop table address */
1905 #define ACTION_MV 15 /* Action number */
1906 #define OBJECT_MV 16 /* Ref to internal object number */
1908 #define LARGEST_BPATCH_MV 16 /* Larger marker values are never written
1909 to backpatch tables */
1911 /* Value indicating an imported symbol record: */
1913 #define IMPORT_MV 32
1915 /* Values indicating an exported symbol record: */
1917 #define EXPORT_MV 33 /* Defined ordinarily */
1918 #define EXPORTSF_MV 34 /* Defined in a system file */
1919 #define EXPORTAC_MV 35 /* Action name */
1921 /* Values used only in branch backpatching: */
1922 /* ###-I've rearranged these, so that BRANCH_MV can be last; Glulx uses the
1923 whole range from BRANCH_MV to BRANCHMAX_MV. */
1925 #define LABEL_MV 36 /* Ditto: marks "jump" operands */
1926 #define DELETED_MV 37 /* Ditto: marks bytes deleted from code */
1927 #define BRANCH_MV 38 /* Used in "asm.c" for routine coding */
1928 #define BRANCHMAX_MV 58 /* In fact, the range BRANCH_MV to
1929 BRANCHMAX_MV all means the same thing.
1930 The position within the range means
1931 how far back from the label to go
1932 to find the opmode byte to modify. */
1934 /* ========================================================================= */
1935 /* Initialisation extern definitions */
1937 /* Note that each subsystem in Inform provides four routines to keep */
1938 /* track of variables and data structures: */
1940 /* init_*_vars should set variables to initial values (they must */
1941 /* not be initialised directly in their declarations */
1942 /* as Inform may need to compile several times in a */
1945 /* *_begin_pass any variable/array initialisation that needs to */
1946 /* happen at the start of the pass through the source */
1948 /* *_allocate_arrays should use my_malloc/my_calloc (see memory.c) */
1949 /* to allocate any arrays or workspace needed */
1951 /* *_free_arrays should use my_free to free all memory allocated */
1952 /* (with one exception in "text.c") */
1954 /* ========================================================================= */
1956 /* > READ INFORM SOURCE */
1958 /* My Source Book */
1960 extern void init_arrays_vars(void); /* arrays: construct tableaux */
1961 extern void init_asm_vars(void); /* asm: assemble even rare or v6 codes */
1962 extern void init_bpatch_vars(void); /* bpatch: backpatches code */
1963 extern void init_chars_vars(void); /* chars: translate character sets */
1964 extern void init_directs_vars(void); /* directs: ponder directives */
1965 extern void init_errors_vars(void); /* errors: issue diagnostics */
1966 extern void init_expressc_vars(void); /* expressc: compile expressions */
1967 extern void init_expressp_vars(void); /* expressp: parse expressions */
1968 extern void init_files_vars(void); /* files: handle files */
1969 /* void init_vars(void); inform: decide what to do */
1970 extern void init_lexer_vars(void); /* lexer: lexically analyse source */
1971 extern void init_linker_vars(void); /* linker: link in pre-compiled module */
1972 extern void init_memory_vars(void); /* memory: manage memory settings */
1973 extern void init_objects_vars(void); /* objects: cultivate object tree */
1974 extern void init_states_vars(void); /* states: translate statements to code*/
1975 extern void init_symbols_vars(void); /* symbols: construct symbols table */
1976 extern void init_syntax_vars(void); /* syntax: parse the program */
1977 extern void init_tables_vars(void); /* tables: glue tables into the output */
1978 extern void init_text_vars(void); /* text: encode text and dictionary */
1979 extern void init_veneer_vars(void); /* veneer: compile a layer of code */
1980 extern void init_verbs_vars(void); /* verbs: lay out grammar */
1982 extern void files_begin_prepass(void); /* These routines initialise just */
1983 extern void lexer_begin_prepass(void); /* enough to begin loading source */
1985 extern void arrays_begin_pass(void);
1986 extern void asm_begin_pass(void);
1987 extern void bpatch_begin_pass(void);
1988 extern void chars_begin_pass(void);
1989 extern void directs_begin_pass(void);
1990 extern void errors_begin_pass(void);
1991 extern void expressc_begin_pass(void);
1992 extern void expressp_begin_pass(void);
1993 extern void files_begin_pass(void);
1994 /* void begin_pass(void); */
1995 extern void lexer_begin_pass(void);
1996 extern void linker_begin_pass(void);
1997 extern void memory_begin_pass(void);
1998 extern void objects_begin_pass(void);
1999 extern void states_begin_pass(void);
2000 extern void symbols_begin_pass(void);
2001 extern void syntax_begin_pass(void);
2002 extern void tables_begin_pass(void);
2003 extern void text_begin_pass(void);
2004 extern void veneer_begin_pass(void);
2005 extern void verbs_begin_pass(void);
2007 extern void lexer_endpass(void);
2008 extern void linker_endpass(void);
2010 extern void arrays_allocate_arrays(void);
2011 extern void asm_allocate_arrays(void);
2012 extern void bpatch_allocate_arrays(void);
2013 extern void chars_allocate_arrays(void);
2014 extern void directs_allocate_arrays(void);
2015 extern void errors_allocate_arrays(void);
2016 extern void expressc_allocate_arrays(void);
2017 extern void expressp_allocate_arrays(void);
2018 extern void files_allocate_arrays(void);
2019 /* void allocate_arrays(void); */
2020 extern void lexer_allocate_arrays(void);
2021 extern void linker_allocate_arrays(void);
2022 extern void memory_allocate_arrays(void);
2023 extern void objects_allocate_arrays(void);
2024 extern void states_allocate_arrays(void);
2025 extern void symbols_allocate_arrays(void);
2026 extern void syntax_allocate_arrays(void);
2027 extern void tables_allocate_arrays(void);
2028 extern void text_allocate_arrays(void);
2029 extern void veneer_allocate_arrays(void);
2030 extern void verbs_allocate_arrays(void);
2032 extern void arrays_free_arrays(void);
2033 extern void asm_free_arrays(void);
2034 extern void bpatch_free_arrays(void);
2035 extern void chars_free_arrays(void);
2036 extern void directs_free_arrays(void);
2037 extern void errors_free_arrays(void);
2038 extern void expressc_free_arrays(void);
2039 extern void expressp_free_arrays(void);
2040 extern void files_free_arrays(void);
2041 /* void free_arrays(void); */
2042 extern void lexer_free_arrays(void);
2043 extern void linker_free_arrays(void);
2044 extern void memory_free_arrays(void);
2045 extern void objects_free_arrays(void);
2046 extern void states_free_arrays(void);
2047 extern void symbols_free_arrays(void);
2048 extern void syntax_free_arrays(void);
2049 extern void tables_free_arrays(void);
2050 extern void text_free_arrays(void);
2051 extern void veneer_free_arrays(void);
2052 extern void verbs_free_arrays(void);
2054 /* ========================================================================= */
2055 /* Remaining extern definitions are given by file in alphabetical order */
2056 /* ------------------------------------------------------------------------- */
2057 /* Extern definitions for "arrays" */
2058 /* ------------------------------------------------------------------------- */
2060 extern int no_globals, no_arrays;
2061 extern int dynamic_array_area_size;
2062 extern int *dynamic_array_area;
2063 extern int32 *global_initial_value;
2064 extern int32 *array_symbols;
2065 extern int *array_sizes, *array_types;
2067 extern void make_global(int array_flag, int name_only);
2068 extern void set_variable_value(int i, int32 v);
2069 extern void check_globals(void);
2070 extern int32 begin_table_array(void);
2071 extern int32 begin_word_array(void);
2072 extern void array_entry(int32 i, assembly_operand VAL);
2073 extern void finish_array(int32 i);
2075 /* ------------------------------------------------------------------------- */
2076 /* Extern definitions for "asm" */
2077 /* ------------------------------------------------------------------------- */
2079 extern memory_block zcode_area;
2080 extern int32 zmachine_pc;
2082 extern int32 no_instructions;
2083 extern int sequence_point_follows;
2084 extern int uses_unicode_features, uses_memheap_features,
2085 uses_acceleration_features, uses_float_features;
2086 extern debug_location statement_debug_location;
2087 extern int execution_never_reaches_here;
2088 extern int *variable_usage;
2089 extern int next_label, no_sequence_points;
2090 extern int32 *variable_tokens;
2091 extern assembly_instruction AI;
2092 extern int32 *named_routine_symbols;
2094 extern void print_operand(assembly_operand o);
2095 extern char *variable_name(int32 i);
2096 extern void set_constant_ot(assembly_operand *AO);
2097 extern int is_constant_ot(int otval);
2098 extern int is_variable_ot(int otval);
2099 extern void assemblez_instruction(assembly_instruction *a);
2100 extern void assembleg_instruction(assembly_instruction *a);
2101 extern void assemble_label_no(int n);
2102 extern void assemble_jump(int n);
2103 extern void define_symbol_label(int symbol);
2104 extern int32 assemble_routine_header(int no_locals, int debug_flag,
2105 char *name, int embedded_flag, int the_symbol);
2106 extern void assemble_routine_end(int embedded_flag, debug_locations locations);
2108 extern void assemblez_0(int internal_number);
2109 extern void assemblez_0_to(int internal_number, assembly_operand o1);
2110 extern void assemblez_0_branch(int internal_number, int label, int flag);
2111 extern void assemblez_1(int internal_number, assembly_operand o1);
2112 extern void assemblez_1_to(int internal_number,
2113 assembly_operand o1, assembly_operand st);
2114 extern void assemblez_1_branch(int internal_number,
2115 assembly_operand o1, int label, int flag);
2116 extern void assemblez_objcode(int internal_number,
2117 assembly_operand o1, assembly_operand st,
2118 int label, int flag);
2119 extern void assemblez_2(int internal_number,
2120 assembly_operand o1, assembly_operand o2);
2121 extern void assemblez_2_to(int internal_number,
2122 assembly_operand o1, assembly_operand o2,
2123 assembly_operand st);
2124 extern void assemblez_2_branch(int internal_number,
2125 assembly_operand o1, assembly_operand o2,
2126 int label, int flag);
2127 extern void assemblez_3(int internal_number,
2128 assembly_operand o1, assembly_operand o2,
2129 assembly_operand o3);
2130 extern void assemblez_3_branch(int internal_number,
2131 assembly_operand o1, assembly_operand o2,
2132 assembly_operand o3, int label, int flag);
2133 extern void assemblez_3_to(int internal_number,
2134 assembly_operand o1, assembly_operand o2,
2135 assembly_operand o3, assembly_operand st);
2136 extern void assemblez_4(int internal_number,
2137 assembly_operand o1, assembly_operand o2,
2138 assembly_operand o3, assembly_operand o4);
2139 extern void assemblez_5(int internal_number,
2140 assembly_operand o1, assembly_operand o2,
2141 assembly_operand o3, assembly_operand o4,
2142 assembly_operand o5);
2143 extern void assemblez_6(int internal_number,
2144 assembly_operand o1, assembly_operand o2,
2145 assembly_operand o3, assembly_operand o4,
2146 assembly_operand o5, assembly_operand o6);
2147 extern void assemblez_4_branch(int internal_number,
2148 assembly_operand o1, assembly_operand o2,
2149 assembly_operand o3, assembly_operand o4,
2150 int label, int flag);
2151 extern void assemblez_4_to(int internal_number,
2152 assembly_operand o1, assembly_operand o2,
2153 assembly_operand o3, assembly_operand o4,
2154 assembly_operand st);
2155 extern void assemblez_5_to(int internal_number,
2156 assembly_operand o1, assembly_operand o2,
2157 assembly_operand o3, assembly_operand o4,
2158 assembly_operand o5, assembly_operand st);
2160 extern void assemblez_inc(assembly_operand o1);
2161 extern void assemblez_dec(assembly_operand o1);
2162 extern void assemblez_store(assembly_operand o1, assembly_operand o2);
2163 extern void assemblez_jump(int n);
2165 extern void assembleg_0(int internal_number);
2166 extern void assembleg_1(int internal_number, assembly_operand o1);
2167 extern void assembleg_2(int internal_number, assembly_operand o1,
2168 assembly_operand o2);
2169 extern void assembleg_3(int internal_number, assembly_operand o1,
2170 assembly_operand o2, assembly_operand o3);
2171 extern void assembleg_4(int internal_number, assembly_operand o1,
2172 assembly_operand o2, assembly_operand o3, assembly_operand o4);
2173 extern void assembleg_5(int internal_number, assembly_operand o1,
2174 assembly_operand o2, assembly_operand o3, assembly_operand o4,
2175 assembly_operand o5);
2176 extern void assembleg_0_branch(int internal_number,
2178 extern void assembleg_1_branch(int internal_number,
2179 assembly_operand o1, int label);
2180 extern void assembleg_2_branch(int internal_number,
2181 assembly_operand o1, assembly_operand o2, int label);
2182 extern void assembleg_call_1(assembly_operand oaddr, assembly_operand o1,
2183 assembly_operand odest);
2184 extern void assembleg_call_2(assembly_operand oaddr, assembly_operand o1,
2185 assembly_operand o2, assembly_operand odest);
2186 extern void assembleg_call_3(assembly_operand oaddr, assembly_operand o1,
2187 assembly_operand o2, assembly_operand o3, assembly_operand odest);
2188 extern void assembleg_inc(assembly_operand o1);
2189 extern void assembleg_dec(assembly_operand o1);
2190 extern void assembleg_store(assembly_operand o1, assembly_operand o2);
2191 extern void assembleg_jump(int n);
2193 extern void parse_assembly(void);
2195 /* ------------------------------------------------------------------------- */
2196 /* Extern definitions for "bpatch" */
2197 /* ------------------------------------------------------------------------- */
2199 extern memory_block zcode_backpatch_table, zmachine_backpatch_table;
2200 extern int32 zcode_backpatch_size, zmachine_backpatch_size;
2201 extern int backpatch_marker, backpatch_error_flag;
2203 extern int32 backpatch_value(int32 value);
2204 extern void backpatch_zmachine_image_z(void);
2205 extern void backpatch_zmachine_image_g(void);
2206 extern void backpatch_zmachine(int mv, int zmachine_area, int32 offset);
2208 /* ------------------------------------------------------------------------- */
2209 /* Extern definitions for "chars" */
2210 /* ------------------------------------------------------------------------- */
2212 extern uchar source_to_iso_grid[];
2213 extern int32 iso_to_unicode_grid[];
2214 extern int character_digit_value[];
2215 extern uchar alphabet[3][27];
2216 extern int alphabet_modified;
2217 extern int zscii_defn_modified;
2218 extern int zscii_high_water_mark;
2219 extern char alphabet_used[];
2220 extern int iso_to_alphabet_grid[];
2221 extern int zscii_to_alphabet_grid[];
2222 extern int textual_form_length;
2224 extern int iso_to_unicode(int iso);
2225 extern int unicode_to_zscii(int32 u);
2226 extern int32 zscii_to_unicode(int z);
2227 extern int32 text_to_unicode(char *text);
2228 extern void zscii_to_text(char *text, int zscii);
2229 extern char *name_of_iso_set(int s);
2230 extern void change_character_set(void);
2231 extern void new_alphabet(char *text, int alphabet);
2232 extern void new_zscii_character(int32 unicode, int plus_flag);
2233 extern void new_zscii_finished(void);
2234 extern void map_new_zchar(int32 unicode);
2235 extern void make_lower_case(char *str);
2236 extern void make_upper_case(char *str);
2238 /* ------------------------------------------------------------------------- */
2239 /* Extern definitions for "directs" */
2240 /* ------------------------------------------------------------------------- */
2242 extern brief_location routine_starts_line;
2244 extern int no_routines, no_named_routines, no_locals, no_termcs;
2245 extern int terminating_characters[];
2247 extern int parse_given_directive(int internal_flag);
2249 /* ------------------------------------------------------------------------- */
2250 /* Extern definitions for "errors" */
2251 /* ------------------------------------------------------------------------- */
2253 extern char *forerrors_buff;
2254 extern int forerrors_pointer;
2255 extern int no_errors, no_warnings, no_suppressed_warnings,
2256 no_link_errors, no_compiler_errors;
2258 extern ErrorPosition ErrorReport;
2260 extern void fatalerror(char *s) NORETURN;
2261 extern void fatalerror_named(char *s1, char *s2) NORETURN;
2262 extern void memory_out_error(int32 size, int32 howmany, char *name) NORETURN;
2263 extern void memoryerror(char *s, int32 size) NORETURN;
2264 extern void error(char *s);
2265 extern void error_named(char *s1, char *s2);
2266 extern void error_numbered(char *s1, int val);
2267 extern void error_named_at(char *s1, char *s2, brief_location report_line);
2268 extern void ebf_error(char *s1, char *s2);
2269 extern void char_error(char *s, int ch);
2270 extern void unicode_char_error(char *s, int32 uni);
2271 extern void no_such_label(char *lname);
2272 extern void warning(char *s);
2273 extern void warning_numbered(char *s1, int val);
2274 extern void warning_named(char *s1, char *s2);
2275 extern void dbnu_warning(char *type, char *name, brief_location report_line);
2276 extern void uncalled_routine_warning(char *type, char *name, brief_location report_line);
2277 extern void obsolete_warning(char *s1);
2278 extern void link_error(char *s);
2279 extern void link_error_named(char *s1, char *s2);
2280 extern int compiler_error(char *s);
2281 extern int compiler_error_named(char *s1, char *s2);
2282 extern void print_sorry_message(void);
2284 #ifdef ARC_THROWBACK
2285 extern int throwback_switch;
2287 extern void throwback(int severity, char * error);
2288 extern void throwback_start(void);
2289 extern void throwback_end(void);
2292 /* ------------------------------------------------------------------------- */
2293 /* Extern definitions for "expressc" */
2294 /* ------------------------------------------------------------------------- */
2296 extern int vivc_flag;
2297 extern operator operators[];
2299 extern assembly_operand stack_pointer, temp_var1, temp_var2, temp_var3,
2300 temp_var4, zero_operand, one_operand, two_operand, three_operand,
2301 four_operand, valueless_operand;
2303 assembly_operand code_generate(assembly_operand AO, int context, int label);
2304 assembly_operand check_nonzero_at_runtime(assembly_operand AO1, int label,
2307 /* ------------------------------------------------------------------------- */
2308 /* Extern definitions for "expressp" */
2309 /* ------------------------------------------------------------------------- */
2311 extern int system_function_usage[];
2312 extern expression_tree_node *ET;
2314 extern int z_system_constant_list[];
2315 extern int glulx_system_constant_list[];
2317 extern int32 value_of_system_constant(int t);
2318 extern void clear_expression_space(void);
2319 extern void show_tree(assembly_operand AO, int annotate);
2320 extern assembly_operand parse_expression(int context);
2321 extern int test_for_incdec(assembly_operand AO);
2323 /* ------------------------------------------------------------------------- */
2324 /* Extern definitions for "files" */
2325 /* ------------------------------------------------------------------------- */
2327 extern int total_files;
2328 extern int current_input_file;
2329 extern int total_input_files;
2330 extern FileId *InputFiles;
2332 extern FILE *Temp1_fp, *Temp2_fp, *Temp3_fp;
2333 extern char Temp1_Name[], Temp2_Name[], Temp3_Name[];
2334 extern int32 total_chars_read;
2336 extern void open_temporary_files(void);
2337 extern void check_temp_files(void);
2338 extern void remove_temp_files(void);
2340 extern void open_transcript_file(char *what_of);
2341 extern void write_to_transcript_file(char *text);
2342 extern void close_transcript_file(void);
2343 extern void abort_transcript_file(void);
2345 extern void nullify_debug_file_position(maybe_file_position *position);
2347 extern void begin_debug_file(void);
2349 extern void debug_file_printf(const char*format, ...);
2350 extern void debug_file_print_with_entities(const char*string);
2351 extern void debug_file_print_base_64_triple
2352 (uchar first, uchar second, uchar third);
2353 extern void debug_file_print_base_64_pair(uchar first, uchar second);
2354 extern void debug_file_print_base_64_single(uchar first);
2356 extern void write_debug_location(debug_location location);
2357 extern void write_debug_locations(debug_locations locations);
2358 extern void write_debug_optional_identifier(int32 symbol_index);
2359 extern void write_debug_symbol_backpatch(int32 symbol_index);
2360 extern void write_debug_symbol_optional_backpatch(int32 symbol_index);
2361 extern void write_debug_object_backpatch(int32 object_number);
2362 extern void write_debug_packed_code_backpatch(int32 offset);
2363 extern void write_debug_code_backpatch(int32 offset);
2364 extern void write_debug_global_backpatch(int32 offset);
2365 extern void write_debug_array_backpatch(int32 offset);
2366 extern void write_debug_grammar_backpatch(int32 offset);
2368 extern void begin_writing_debug_sections(void);
2369 extern void write_debug_section(const char*name, int32 beginning_address);
2370 extern void end_writing_debug_sections(int32 end_address);
2372 extern void write_debug_undef(int32 symbol_index);
2374 extern void end_debug_file(void);
2376 extern void add_to_checksum(void *address);
2378 extern void load_sourcefile(char *story_name, int style);
2379 extern int file_load_chars(int file_number, char *buffer, int length);
2380 extern void close_all_source(void);
2381 extern int register_orig_sourcefile(char *filename);
2383 extern void output_file(void);
2385 /* ------------------------------------------------------------------------- */
2386 /* Extern definitions for "inform" */
2387 /* ------------------------------------------------------------------------- */
2389 extern char Code_Name[];
2390 extern int endofpass_flag;
2392 extern int version_number, instruction_set_number, extend_memory_map;
2393 extern int32 scale_factor, length_scale_factor;
2395 extern int WORDSIZE, INDIV_PROP_START,
2396 OBJECT_BYTE_LENGTH, DICT_ENTRY_BYTE_LENGTH, DICT_ENTRY_FLAG_POS;
2397 extern int32 MAXINTWORD;
2399 extern int asm_trace_level, line_trace_level, expr_trace_level,
2400 linker_trace_level, tokens_trace_level;
2403 bothpasses_switch, concise_switch,
2404 economy_switch, frequencies_switch,
2405 ignore_switches_switch, listobjects_switch, debugfile_switch,
2406 listing_switch, memout_switch, printprops_switch,
2407 offsets_switch, percentages_switch, obsolete_switch,
2408 transcript_switch, statistics_switch, optimise_switch,
2409 version_set_switch, nowarnings_switch, hash_switch,
2410 memory_map_switch, module_switch, temporary_files_switch,
2411 define_DEBUG_switch, define_USE_MODULES_switch, define_INFIX_switch,
2412 runtime_error_checking_switch;
2414 extern int oddeven_packing_switch;
2416 extern int glulx_mode, compression_switch;
2417 extern int32 requested_glulx_version;
2419 extern int error_format, store_the_text, asm_trace_setting,
2420 double_space_setting, trace_fns_setting, character_set_setting,
2421 character_set_unicode;
2423 extern char Debugging_Name[];
2424 extern char Transcript_Name[];
2425 extern char Language_Name[];
2426 extern char Charset_Map[];
2428 extern char banner_line[];
2430 extern void select_version(int vn);
2431 extern void switches(char *, int);
2432 extern int translate_in_filename(int last_value, char *new_name, char *old_name,
2433 int same_directory_flag, int command_line_flag);
2434 extern void translate_out_filename(char *new_name, char *old_name);
2435 extern int translate_link_filename(int last_value,
2436 char *new_name, char *old_name);
2437 extern void translate_temp_filename(int i);
2440 extern char *riscos_file_type(void);
2443 /* For the benefit of the MAC_FACE port these are declared extern, though
2444 unused outside "inform" in the compiler itself */
2446 extern void allocate_arrays(void);
2447 extern void free_arrays(void);
2449 /* ------------------------------------------------------------------------- */
2450 /* Extern definitions for "lexer" */
2451 /* ------------------------------------------------------------------------- */
2453 extern int hash_printed_since_newline;
2454 extern int total_source_line_count;
2455 extern int dont_enter_into_symbol_table;
2456 extern int return_sp_as_variable;
2457 extern int next_token_begins_syntax_line;
2458 extern char **local_variable_texts;
2460 extern int32 token_value;
2461 extern int token_type;
2462 extern char *token_text;
2464 extern debug_location get_token_location(void);
2465 extern debug_locations get_token_locations(void);
2466 extern debug_location_beginning get_token_location_beginning(void);
2467 extern void discard_token_location(debug_location_beginning beginning);
2468 extern debug_locations get_token_location_end(debug_location_beginning beginning);
2470 extern void describe_token(token_data t);
2472 extern void construct_local_variable_tables(void);
2473 extern void declare_systemfile(void);
2474 extern int is_systemfile(void);
2475 extern void report_errors_at_current_line(void);
2476 extern debug_location get_current_debug_location(void);
2477 extern debug_location get_error_report_debug_location(void);
2478 extern int32 get_current_line_start(void);
2479 extern void set_origsource_location(char *source, int32 line, int32 charnum);
2480 extern brief_location get_brief_location(ErrorPosition *errpos);
2481 extern void export_brief_location(brief_location loc, ErrorPosition *errpos);
2482 extern brief_location blank_brief_location;
2484 extern void put_token_back(void);
2485 extern void get_next_token(void);
2486 extern void restart_lexer(char *lexical_source, char *name);
2488 extern keyword_group directives, statements, segment_markers,
2489 conditions, system_functions, local_variables, opcode_names,
2490 misc_keywords, directive_keywords, trace_keywords, system_constants,
2493 /* ------------------------------------------------------------------------- */
2494 /* Extern definitions for "linker" */
2495 /* ------------------------------------------------------------------------- */
2497 extern memory_block link_data_area;
2498 extern int32 link_data_size;
2499 extern char current_module_filename[];
2501 extern char *describe_mv(int mval);
2502 extern void write_link_marker(int zmachine_area, int32 offset,
2503 assembly_operand op);
2504 extern void flush_link_data(void);
2505 extern void import_symbol(int32 symbol_number);
2506 extern void export_symbol(int32 symbol_number);
2507 extern void export_symbol_name(int32 i);
2508 extern void link_module(char *filename);
2510 /* ------------------------------------------------------------------------- */
2511 /* Extern definitions for "memory" */
2512 /* ------------------------------------------------------------------------- */
2514 extern int32 malloced_bytes;
2516 extern int MAX_QTEXT_SIZE, MAX_SYMBOLS, HASH_TAB_SIZE, MAX_DICT_ENTRIES,
2517 MAX_OBJECTS, MAX_ACTIONS, MAX_ADJECTIVES, MAX_ABBREVS,
2518 MAX_STATIC_DATA, MAX_PROP_TABLE_SIZE, SYMBOLS_CHUNK_SIZE,
2519 MAX_EXPRESSION_NODES, MAX_LABELS, MAX_LINESPACE,
2520 MAX_LOW_STRINGS, MAX_CLASSES, MAX_VERBS,
2521 MAX_VERBSPACE, MAX_ARRAYS, MAX_INCLUSION_DEPTH,
2524 extern int32 MAX_STATIC_STRINGS, MAX_ZCODE_SIZE, MAX_LINK_DATA_SIZE,
2525 MAX_TRANSCRIPT_SIZE, MAX_INDIV_PROP_TABLE_SIZE,
2526 MAX_NUM_STATIC_STRINGS, MAX_UNICODE_CHARS,
2527 MAX_STACK_SIZE, MEMORY_MAP_EXTENSION;
2529 extern int32 MAX_OBJ_PROP_COUNT, MAX_OBJ_PROP_TABLE_SIZE;
2530 extern int MAX_LOCAL_VARIABLES, MAX_GLOBAL_VARIABLES;
2531 extern int DICT_WORD_SIZE, DICT_CHAR_SIZE, DICT_WORD_BYTES;
2532 extern int ZCODE_HEADER_EXT_WORDS, ZCODE_HEADER_FLAGS_3;
2533 extern int NUM_ATTR_BYTES, GLULX_OBJECT_EXT_BYTES;
2534 extern int WARN_UNUSED_ROUTINES, OMIT_UNUSED_ROUTINES;
2536 /* These macros define offsets that depend on the value of NUM_ATTR_BYTES.
2537 (Meaningful only for Glulx.) */
2538 /* GOBJFIELD: word offsets of various elements in the object structure. */
2539 #define GOBJFIELD_CHAIN() (1+((NUM_ATTR_BYTES)/4))
2540 #define GOBJFIELD_NAME() (2+((NUM_ATTR_BYTES)/4))
2541 #define GOBJFIELD_PROPTAB() (3+((NUM_ATTR_BYTES)/4))
2542 #define GOBJFIELD_PARENT() (4+((NUM_ATTR_BYTES)/4))
2543 #define GOBJFIELD_SIBLING() (5+((NUM_ATTR_BYTES)/4))
2544 #define GOBJFIELD_CHILD() (6+((NUM_ATTR_BYTES)/4))
2546 extern void *my_malloc(int32 size, char *whatfor);
2547 extern void my_realloc(void *pointer, int32 oldsize, int32 size,
2549 extern void *my_calloc(int32 size, int32 howmany, char *whatfor);
2550 extern void my_recalloc(void *pointer, int32 size, int32 oldhowmany,
2551 int32 howmany, char *whatfor);
2552 extern void my_free(void *pointer, char *whatitwas);
2554 extern void set_memory_sizes(int size_flag);
2555 extern void adjust_memory_sizes(void);
2556 extern void memory_command(char *command);
2557 extern void print_memory_usage(void);
2559 extern void initialise_memory_block(memory_block *MB);
2560 extern void deallocate_memory_block(memory_block *MB);
2561 extern int read_byte_from_memory_block(memory_block *MB, int32 index);
2562 extern void write_byte_to_memory_block(memory_block *MB,
2563 int32 index, int value);
2565 /* ------------------------------------------------------------------------- */
2566 /* Extern definitions for "objects" */
2567 /* ------------------------------------------------------------------------- */
2569 extern int no_attributes, no_properties;
2570 extern int no_individual_properties;
2571 extern int individuals_length;
2572 extern uchar *individuals_table;
2573 extern int no_classes, no_objects;
2574 extern objecttz *objectsz;
2575 extern objecttg *objectsg;
2576 extern uchar *objectatts;
2577 extern int *class_object_numbers;
2578 extern int32 *class_begins_at;
2580 extern int32 *prop_default_value;
2581 extern int *prop_is_long;
2582 extern int *prop_is_additive;
2583 extern char *properties_table;
2584 extern int properties_table_size;
2586 extern void make_attribute(void);
2587 extern void make_property(void);
2588 extern void make_object(int nearby_flag,
2589 char *textual_name, int specified_parent, int specified_class,
2591 extern void make_class(char *metaclass_name);
2592 extern int object_provides(int obj, int id);
2593 extern void list_object_tree(void);
2594 extern void write_the_identifier_names(void);
2596 /* ------------------------------------------------------------------------- */
2597 /* Extern definitions for "symbols" */
2598 /* ------------------------------------------------------------------------- */
2600 extern int no_named_constants;
2601 extern int no_symbols;
2602 extern int32 **symbs;
2603 extern int32 *svals;
2605 extern brief_location *slines;
2608 extern char *stypes;
2610 extern signed char *stypes;
2612 extern maybe_file_position *symbol_debug_backpatch_positions;
2613 extern maybe_file_position *replacement_debug_backpatch_positions;
2614 extern int32 *individual_name_strings;
2615 extern int32 *attribute_name_strings;
2616 extern int32 *action_name_strings;
2617 extern int32 *array_name_strings;
2618 extern int track_unused_routines;
2619 extern int df_dont_note_global_symbols;
2620 extern uint32 df_total_size_before_stripping;
2621 extern uint32 df_total_size_after_stripping;
2623 extern char *typename(int type);
2624 extern int hash_code_from_string(char *p);
2625 extern int strcmpcis(char *p, char *q);
2626 extern int symbol_index(char *lexeme_text, int hashcode);
2627 extern void end_symbol_scope(int k);
2628 extern void describe_symbol(int k);
2629 extern void list_symbols(int level);
2630 extern void assign_marked_symbol(int index, int marker, int32 value, int type);
2631 extern void assign_symbol(int index, int32 value, int type);
2632 extern void issue_unused_warnings(void);
2633 extern void add_symbol_replacement_mapping(int original, int renamed);
2634 extern int find_symbol_replacement(int *value);
2635 extern void df_note_function_start(char *name, uint32 address,
2636 int embedded_flag, brief_location source_line);
2637 extern void df_note_function_end(uint32 endaddress);
2638 extern void df_note_function_symbol(int symbol);
2639 extern void locate_dead_functions(void);
2640 extern uint32 df_stripped_address_for_address(uint32);
2641 extern uint32 df_stripped_offset_for_code_offset(uint32, int *);
2642 extern void df_prepare_function_iterate(void);
2643 extern uint32 df_next_function_iterate(int *);
2645 /* ------------------------------------------------------------------------- */
2646 /* Extern definitions for "syntax" */
2647 /* ------------------------------------------------------------------------- */
2649 extern int no_syntax_lines;
2651 extern void panic_mode_error_recovery(void);
2652 extern void get_next_token_with_directives(void);
2653 extern int parse_directive(int internal_flag);
2654 extern void parse_program(char *source);
2655 extern int32 parse_routine(char *source, int embedded_flag, char *name,
2656 int veneer_flag, int r_symbol);
2657 extern void parse_code_block(int break_label, int continue_label,
2660 /* ------------------------------------------------------------------------- */
2661 /* Extern definitions for "states" */
2662 /* ------------------------------------------------------------------------- */
2664 extern void match_close_bracket(void);
2665 extern void parse_statement(int break_label, int continue_label);
2666 extern int parse_label(void);
2668 /* ------------------------------------------------------------------------- */
2669 /* Extern definitions for "tables" */
2670 /* ------------------------------------------------------------------------- */
2672 extern uchar *zmachine_paged_memory;
2674 code_offset, actions_offset, preactions_offset,
2675 dictionary_offset, strings_offset, adjectives_offset,
2676 variables_offset, class_numbers_offset, individuals_offset,
2677 identifier_names_offset, prop_defaults_offset, prop_values_offset,
2678 static_memory_offset, array_names_offset, attribute_names_offset,
2679 action_names_offset, fake_action_names_offset,
2680 routine_names_offset, routines_array_offset, routine_flags_array_offset,
2681 global_names_offset, global_flags_array_offset,
2682 array_flags_array_offset, constant_names_offset, constants_array_offset;
2684 arrays_offset, object_tree_offset, grammar_table_offset,
2685 abbreviations_offset; /* For Glulx */
2687 extern int32 Out_Size, Write_Code_At, Write_Strings_At;
2688 extern int32 RAM_Size, Write_RAM_At; /* For Glulx */
2690 extern int release_number, statusline_flag;
2691 extern int flags2_requirements[];
2692 extern int serial_code_given_in_program;
2693 extern char serial_code_buffer[];
2695 extern void construct_storyfile(void);
2696 extern void write_serial_number(char *buffer);
2698 /* ------------------------------------------------------------------------- */
2699 /* Extern definitions for "text" */
2700 /* ------------------------------------------------------------------------- */
2702 extern uchar *low_strings, *low_strings_top;
2703 extern char *all_text, *all_text_top;
2705 extern int no_abbreviations;
2706 extern int abbrevs_lookup_table_made, is_abbreviation;
2707 extern uchar *abbreviations_at;
2708 extern int *abbrev_values;
2709 extern int *abbrev_quality;
2710 extern int *abbrev_freqs;
2712 extern int32 total_chars_trans, total_bytes_trans,
2713 zchars_trans_in_last_string;
2714 extern int put_strings_in_low_memory;
2715 extern int dict_entries;
2716 extern uchar *dictionary, *dictionary_top;
2717 extern int *final_dict_order;
2719 extern memory_block static_strings_area;
2720 extern int32 static_strings_extent;
2722 /* And now, a great many declarations for dealing with Glulx string
2725 extern int32 no_strings, no_dynamic_strings;
2726 extern int no_unicode_chars;
2728 #define MAX_DYNAMIC_STRINGS (64)
2730 typedef struct unicode_usage_s unicode_usage_t;
2731 struct unicode_usage_s {
2733 unicode_usage_t *next;
2736 extern unicode_usage_t *unicode_usage_entries;
2738 /* This is the maximum number of (8-bit) bytes that can encode a single
2739 Huffman entity. Four should be plenty, unless someone starts encoding
2740 an ideographic language. */
2741 #define MAXHUFFBYTES (4)
2743 typedef struct huffbitlist_struct {
2744 uchar b[MAXHUFFBYTES];
2746 typedef struct huffentity_struct {
2759 extern huffentity_t *huff_entities;
2761 extern int32 compression_table_size, compression_string_size;
2762 extern int32 *compressed_offsets;
2763 extern int no_huff_entities;
2764 extern int huff_abbrev_start, huff_dynam_start, huff_unicode_start;
2765 extern int huff_entity_root;
2767 extern void compress_game_text(void);
2769 /* end of the Glulx string compression stuff */
2771 extern void ao_free_arrays(void);
2772 extern int32 compile_string(char *b, int in_low_memory, int is_abbrev);
2773 extern uchar *translate_text(uchar *p, uchar *p_limit, char *s_text);
2774 extern void optimise_abbreviations(void);
2775 extern void make_abbreviation(char *text);
2776 extern void show_dictionary(void);
2777 extern void word_to_ascii(uchar *p, char *result);
2778 extern void write_dictionary_to_transcript(void);
2779 extern void sort_dictionary(void);
2780 extern void dictionary_prepare(char *dword, uchar *optresult);
2781 extern int dictionary_add(char *dword, int x, int y, int z);
2782 extern void dictionary_set_verb_number(char *dword, int to);
2783 extern int compare_sorts(uchar *d1, uchar *d2);
2784 extern void copy_sorts(uchar *d1, uchar *d2);
2786 /* ------------------------------------------------------------------------- */
2787 /* Extern definitions for "veneer" */
2788 /* ------------------------------------------------------------------------- */
2790 extern int veneer_mode;
2791 extern int32 veneer_routine_address[];
2793 extern void compile_initial_routine(void);
2794 extern assembly_operand veneer_routine(int code);
2795 extern void compile_veneer(void);
2797 /* ------------------------------------------------------------------------- */
2798 /* Extern definitions for "verbs" */
2799 /* ------------------------------------------------------------------------- */
2801 extern int no_adjectives, no_Inform_verbs, no_grammar_token_routines,
2802 no_fake_actions, no_actions, no_grammar_lines, no_grammar_tokens,
2803 grammar_version_number;
2804 extern int32 grammar_version_symbol;
2805 extern verbt *Inform_verbs;
2806 extern uchar *grammar_lines;
2807 extern int32 grammar_lines_top;
2808 extern int32 *action_byte_offset,
2809 *grammar_token_routine,
2812 extern void find_the_actions(void);
2813 extern void make_fake_action(void);
2814 extern assembly_operand action_of_name(char *name);
2815 extern void make_verb(void);
2816 extern void extend_verb(void);
2817 extern void list_verb_table(void);
2819 /* ========================================================================= */