Generating Inform 6

To generate I6 code from intermediate code.

§1. Target.

code_generation_target *inform6_target = NULL;
void CodeGen::I6::create_target(void) {
    code_generation_target *cgt = CodeGen::Targets::new(I"inform6");
    METHOD_ADD(cgt, BEGIN_GENERATION_MTID, CodeGen::I6::begin_generation);
    METHOD_ADD(cgt, GENERAL_SEGMENT_MTID, CodeGen::I6::general_segment);
    METHOD_ADD(cgt, TL_SEGMENT_MTID, CodeGen::I6::tl_segment);
    METHOD_ADD(cgt, DEFAULT_SEGMENT_MTID, CodeGen::I6::default_segment);
    METHOD_ADD(cgt, BASIC_CONSTANT_SEGMENT_MTID, CodeGen::I6::basic_constant_segment);
    METHOD_ADD(cgt, CONSTANT_SEGMENT_MTID, CodeGen::I6::constant_segment);
    METHOD_ADD(cgt, PROPERTY_SEGMENT_MTID, CodeGen::I6::property_segment);
    METHOD_ADD(cgt, COMPILE_PRIMITIVE_MTID, CodeGen::I6::compile_primitive);
    METHOD_ADD(cgt, MANGLE_IDENTIFIER_MTID, CodeGen::I6::mangle);
    METHOD_ADD(cgt, COMPILE_DICTIONARY_WORD_MTID, CodeGen::I6::compile_dictionary_word);
    METHOD_ADD(cgt, COMPILE_LITERAL_NUMBER_MTID, CodeGen::I6::compile_literal_number);
    METHOD_ADD(cgt, COMPILE_LITERAL_TEXT_MTID, CodeGen::I6::compile_literal_text);
    METHOD_ADD(cgt, DECLARE_PROPERTY_MTID, CodeGen::I6::declare_property);
    METHOD_ADD(cgt, DECLARE_ATTRIBUTE_MTID, CodeGen::I6::declare_attribute);
    METHOD_ADD(cgt, PROPERTY_OFFSET_MTID, CodeGen::I6::property_offset);
    METHOD_ADD(cgt, PREPARE_VARIABLE_MTID, CodeGen::I6::prepare_variable);
    METHOD_ADD(cgt, DECLARE_VARIABLE_MTID, CodeGen::I6::declare_variable);
    METHOD_ADD(cgt, DECLARE_CLASS_MTID, CodeGen::I6::declare_class);
    METHOD_ADD(cgt, END_CLASS_MTID, CodeGen::I6::end_class);
    METHOD_ADD(cgt, DECLARE_INSTANCE_MTID, CodeGen::I6::declare_instance);
    METHOD_ADD(cgt, END_INSTANCE_MTID, CodeGen::I6::end_instance);
    METHOD_ADD(cgt, ASSIGN_PROPERTY_MTID, CodeGen::I6::assign_property);
    METHOD_ADD(cgt, DECLARE_LOCAL_VARIABLE_MTID, CodeGen::I6::declare_local_variable);
    METHOD_ADD(cgt, BEGIN_CONSTANT_MTID, CodeGen::I6::begin_constant);
    METHOD_ADD(cgt, END_CONSTANT_MTID, CodeGen::I6::end_constant);
    METHOD_ADD(cgt, BEGIN_FUNCTION_MTID, CodeGen::I6::begin_function);
    METHOD_ADD(cgt, BEGIN_FUNCTION_CODE_MTID, CodeGen::I6::begin_function_code);
    METHOD_ADD(cgt, PLACE_LABEL_MTID, CodeGen::I6::place_label);
    METHOD_ADD(cgt, END_FUNCTION_MTID, CodeGen::I6::end_function);
    METHOD_ADD(cgt, BEGIN_FUNCTION_CALL_MTID, CodeGen::I6::begin_function_call);
    METHOD_ADD(cgt, ARGUMENT_MTID, CodeGen::I6::argument);
    METHOD_ADD(cgt, END_FUNCTION_CALL_MTID, CodeGen::I6::end_function_call);
    METHOD_ADD(cgt, BEGIN_OPCODE_MTID, CodeGen::I6::begin_opcode);
    METHOD_ADD(cgt, SUPPLY_OPERAND_MTID, CodeGen::I6::supply_operand);
    METHOD_ADD(cgt, END_OPCODE_MTID, CodeGen::I6::end_opcode);
    METHOD_ADD(cgt, BEGIN_ARRAY_MTID, CodeGen::I6::begin_array);
    METHOD_ADD(cgt, ARRAY_ENTRY_MTID, CodeGen::I6::array_entry);
    METHOD_ADD(cgt, END_ARRAY_MTID, CodeGen::I6::end_array);
    METHOD_ADD(cgt, OFFER_PRAGMA_MTID, CodeGen::I6::offer_pragma)
    METHOD_ADD(cgt, END_GENERATION_MTID, CodeGen::I6::end_generation);
    METHOD_ADD(cgt, NEW_FAKE_ACTION_MTID, CodeGen::I6::new_fake_action);
    inform6_target = cgt;
}

code_generation_target *CodeGen::I6::target(void) {
    return inform6_target;
}

§2. Segmentation. The loss of life is so appalling that I6 will not even compile a story file which doesn't define the property number life (well, strictly speaking, it checks the presence of constants suggesting the I6 library first, but the template layer does define constants like that). We define it as a null constant to be sure of avoiding any valid property number; I6 being typeless, that enables the veneer to compile again. (The relevant code is in CA__Pr, defined in the veneer.c section of I6.)

debug_flag is traditionally called so, but is actually now a bitmap of flags for tracing actions, calls to object routines, and so on.

enum pragmatic_matter_I7CGS from 0
enum compiler_versioning_matter_I7CGS
enum predeclarations_I7CGS
enum very_early_matter_I7CGS
enum constants_1_I7CGS
enum constants_2_I7CGS
enum constants_3_I7CGS
enum constants_4_I7CGS
enum constants_5_I7CGS
enum constants_6_I7CGS
enum constants_7_I7CGS
enum constants_8_I7CGS
enum constants_9_I7CGS
enum constants_10_I7CGS
enum predeclarations_2_I7CGS
enum early_matter_I7CGS
enum text_literals_code_I7CGS
enum summations_at_eof_I7CGS
enum arrays_at_eof_I7CGS
enum globals_array_I7CGS
enum main_matter_I7CGS
enum routines_at_eof_I7CGS
enum code_at_eof_I7CGS
enum verbs_at_eof_I7CGS
enum stubs_at_eof_I7CGS
enum property_offset_creator_I7CGS

int I6_property_offsets_made = 0;
int CodeGen::I6::begin_generation(code_generation_target *cgt, code_generation *gen) {
    gen->segments[pragmatic_matter_I7CGS] = CodeGen::new_segment();
    gen->segments[compiler_versioning_matter_I7CGS] = CodeGen::new_segment();
    gen->segments[predeclarations_I7CGS] = CodeGen::new_segment();
    gen->segments[predeclarations_2_I7CGS] = CodeGen::new_segment();
    gen->segments[very_early_matter_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_1_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_2_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_3_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_4_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_5_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_6_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_7_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_8_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_9_I7CGS] = CodeGen::new_segment();
    gen->segments[constants_10_I7CGS] = CodeGen::new_segment();
    gen->segments[early_matter_I7CGS] = CodeGen::new_segment();
    gen->segments[text_literals_code_I7CGS] = CodeGen::new_segment();
    gen->segments[summations_at_eof_I7CGS] = CodeGen::new_segment();
    gen->segments[arrays_at_eof_I7CGS] = CodeGen::new_segment();
    gen->segments[globals_array_I7CGS] = CodeGen::new_segment();
    gen->segments[main_matter_I7CGS] = CodeGen::new_segment();
    gen->segments[routines_at_eof_I7CGS] = CodeGen::new_segment();
    gen->segments[code_at_eof_I7CGS] = CodeGen::new_segment();
    gen->segments[verbs_at_eof_I7CGS] = CodeGen::new_segment();
    gen->segments[stubs_at_eof_I7CGS] = CodeGen::new_segment();
    gen->segments[property_offset_creator_I7CGS] = CodeGen::new_segment();

    I6_property_offsets_made = 0;

    generated_segment *saved = CodeGen::select(gen, compiler_versioning_matter_I7CGS);
    text_stream *OUT = CodeGen::current(gen);
    WRITE("Constant Grammar__Version 2;\n");
    WRITE("Global debug_flag;\n");
    CodeGen::deselect(gen, saved);

    return FALSE;
}

int CodeGen::I6::end_generation(code_generation_target *cgt, code_generation *gen) {
    if (I6_property_offsets_made > 0) {
        generated_segment *saved = CodeGen::select(gen, property_offset_creator_I7CGS);
        text_stream *OUT = CodeGen::current(gen);
        OUTDENT;
        WRITE("];\n");
        CodeGen::deselect(gen, saved);
    }
    return FALSE;
}

int CodeGen::I6::general_segment(code_generation_target *cgt, code_generation *gen, inter_tree_node *P) {
    switch (P->W.data[ID_IFLD]) {
        case CONSTANT_IST: {
            inter_symbol *con_name =
                InterSymbolsTables::symbol_from_frame_data(P, DEFN_CONST_IFLD);
            int choice = early_matter_I7CGS;
            if (Str::eq(con_name->symbol_name, I"DynamicMemoryAllocation")) choice = very_early_matter_I7CGS;
            if (Inter::Symbols::read_annotation(con_name, LATE_IANN) == 1) choice = code_at_eof_I7CGS;
            if (Inter::Symbols::read_annotation(con_name, BUFFERARRAY_IANN) == 1) choice = arrays_at_eof_I7CGS;
            if (Inter::Symbols::read_annotation(con_name, BYTEARRAY_IANN) == 1) choice = arrays_at_eof_I7CGS;
            if (Inter::Symbols::read_annotation(con_name, TABLEARRAY_IANN) == 1) choice = arrays_at_eof_I7CGS;
            if (P->W.data[FORMAT_CONST_IFLD] == CONSTANT_INDIRECT_LIST) choice = arrays_at_eof_I7CGS;
            if (Inter::Symbols::read_annotation(con_name, VERBARRAY_IANN) == 1) choice = verbs_at_eof_I7CGS;
            if (Inter::Constant::is_routine(con_name)) choice = routines_at_eof_I7CGS;
            return choice;
        }
    }
    return CodeGen::I6::default_segment(cgt);
}

int CodeGen::I6::default_segment(code_generation_target *cgt) {
    return main_matter_I7CGS;
}
int CodeGen::I6::constant_segment(code_generation_target *cgt, code_generation *gen) {
    return early_matter_I7CGS;
}
int CodeGen::I6::basic_constant_segment(code_generation_target *cgt, code_generation *gen, int depth) {
    if (depth >= 10) depth = 10;
    return constants_1_I7CGS + depth - 1;
}
int CodeGen::I6::property_segment(code_generation_target *cgt) {
    return predeclarations_I7CGS;
}
int CodeGen::I6::tl_segment(code_generation_target *cgt) {
    return text_literals_code_I7CGS;
}

void CodeGen::I6::offer_pragma(code_generation_target *cgt, code_generation *gen,
    inter_tree_node *P, text_stream *tag, text_stream *content) {
    if (Str::eq(tag, I"target_I6")) {
        generated_segment *saved = CodeGen::select(gen, pragmatic_matter_I7CGS);
        text_stream *OUT = CodeGen::current(gen);
        WRITE("!%% %S\n", content);
        CodeGen::deselect(gen, saved);
    }
}

void CodeGen::I6::mangle(code_generation_target *cgt, OUTPUT_STREAM, text_stream *identifier) {
    WRITE("%S", identifier);
}

int CodeGen::I6::compile_primitive(code_generation_target *cgt, code_generation *gen,
    inter_symbol *prim_name, inter_tree_node *P) {
    text_stream *OUT = CodeGen::current(gen);
    int suppress_terminal_semicolon = FALSE;
    inter_tree *I = gen->from;
    inter_ti bip = Primitives::to_bip(I, prim_name);
    switch (bip) {
        case INVERSION_BIP:     WRITE("inversion"); break;

        case PLUS_BIP:          WRITE("("); INV_A1; WRITE(" + "); INV_A2; WRITE(")"); break;
        case MINUS_BIP:         WRITE("("); INV_A1; WRITE(" - "); INV_A2; WRITE(")"); break;
        case UNARYMINUS_BIP:    WRITE("(-("); INV_A1; WRITE("))"); break;
        case TIMES_BIP:         WRITE("("); INV_A1; WRITE("*"); INV_A2; WRITE(")"); break;
        case DIVIDE_BIP:        WRITE("("); INV_A1; WRITE("/"); INV_A2; WRITE(")"); break;
        case MODULO_BIP:        WRITE("("); INV_A1; WRITE("%%"); INV_A2; WRITE(")"); break;
        case BITWISEAND_BIP:    WRITE("(("); INV_A1; WRITE(")&("); INV_A2; WRITE("))"); break;
        case BITWISEOR_BIP:     WRITE("(("); INV_A1; WRITE(")|("); INV_A2; WRITE("))"); break;
        case BITWISENOT_BIP:    WRITE("(~("); INV_A1; WRITE("))"); break;

        case NOT_BIP:           WRITE("(~~("); INV_A1; WRITE("))"); break;
        case AND_BIP:           WRITE("(("); INV_A1; WRITE(") && ("); INV_A2; WRITE("))"); break;
        case OR_BIP:            WRITE("(("); INV_A1; WRITE(") || ("); INV_A2; WRITE("))"); break;
        case EQ_BIP:            WRITE("("); INV_A1; WRITE(" == "); INV_A2; WRITE(")"); break;
        case NE_BIP:            WRITE("("); INV_A1; WRITE(" ~= "); INV_A2; WRITE(")"); break;
        case GT_BIP:            WRITE("("); INV_A1; WRITE(" > "); INV_A2; WRITE(")"); break;
        case GE_BIP:            WRITE("("); INV_A1; WRITE(" >= "); INV_A2; WRITE(")"); break;
        case LT_BIP:            WRITE("("); INV_A1; WRITE(" < "); INV_A2; WRITE(")"); break;
        case LE_BIP:            WRITE("("); INV_A1; WRITE(" <= "); INV_A2; WRITE(")"); break;
        case OFCLASS_BIP:       WRITE("("); INV_A1; WRITE(" ofclass "); INV_A2; WRITE(")"); break;
        case HAS_BIP:           WRITE("("); INV_A1; WRITE(" has "); INV_A2; WRITE(")"); break;
        case HASNT_BIP:         WRITE("("); INV_A1; WRITE(" hasnt "); INV_A2; WRITE(")"); break;
        case IN_BIP:            WRITE("("); INV_A1; WRITE(" in "); INV_A2; WRITE(")"); break;
        case NOTIN_BIP:         WRITE("("); INV_A1; WRITE(" notin "); INV_A2; WRITE(")"); break;
        case PROVIDES_BIP:      WRITE("("); INV_A1; WRITE(" provides "); INV_A2; WRITE(")"); break;
        case ALTERNATIVE_BIP:   INV_A1; WRITE(" or "); INV_A2; break;

        case PUSH_BIP:          WRITE("@push "); INV_A1; break;
        case PULL_BIP:          WRITE("@pull "); INV_A1; break;
        case PREINCREMENT_BIP:  WRITE("++("); INV_A1; WRITE(")"); break;
        case POSTINCREMENT_BIP: WRITE("("); INV_A1; WRITE(")++"); break;
        case PREDECREMENT_BIP:  WRITE("--("); INV_A1; WRITE(")"); break;
        case POSTDECREMENT_BIP: WRITE("("); INV_A1; WRITE(")--"); break;
        case STORE_BIP:         WRITE("("); INV_A1; WRITE(" = "); INV_A2; WRITE(")"); break;
        case SETBIT_BIP:        INV_A1; WRITE(" = "); INV_A1; WRITE(" | "); INV_A2; break;
        case CLEARBIT_BIP:      INV_A1; WRITE(" = "); INV_A1; WRITE(" &~ ("); INV_A2; WRITE(")"); break;
        case LOOKUP_BIP:        WRITE("("); INV_A1; WRITE("-->("); INV_A2; WRITE("))"); break;
        case LOOKUPBYTE_BIP:    WRITE("("); INV_A1; WRITE("->("); INV_A2; WRITE("))"); break;
        case LOOKUPREF_BIP:     WRITE("("); INV_A1; WRITE("-->("); INV_A2; WRITE("))"); break;
        case PROPERTYADDRESS_BIP: WRITE("("); INV_A1; WRITE(".& "); INV_A2; WRITE(")"); break;
        case PROPERTYLENGTH_BIP: WRITE("("); INV_A1; WRITE(".# "); INV_A2; WRITE(")"); break;
        case PROPERTYVALUE_BIP: WRITE("("); INV_A1; WRITE("."); INV_A2; WRITE(")"); break;

        case BREAK_BIP:         WRITE("break"); break;
        case CONTINUE_BIP:      WRITE("continue"); break;
        case RETURN_BIP:        Generate primitive for return2.1; break;
        case JUMP_BIP:          WRITE("jump "); INV_A1; break;
        case QUIT_BIP:          WRITE("quit"); break;
        case RESTORE_BIP:       WRITE("restore "); INV_A1; break;

        case INDIRECT0_BIP: case INDIRECT0V_BIP:
                                WRITE("("); INV_A1; WRITE(")()"); break;
        case INDIRECT1_BIP: case INDIRECT1V_BIP:
                                WRITE("("); INV_A1; WRITE(")(");
                                INV_A2; WRITE(")"); break;
        case INDIRECT2_BIP: case INDIRECT2V_BIP:
                                WRITE("("); INV_A1; WRITE(")(");
                                INV_A2; WRITE(","); INV_A3; WRITE(")"); break;
        case INDIRECT3_BIP: case INDIRECT3V_BIP:
                                WRITE("("); INV_A1; WRITE(")(");
                                INV_A2; WRITE(","); INV_A3; WRITE(","); INV_A4; WRITE(")"); break;
        case INDIRECT4_BIP: case INDIRECT4V_BIP:
                                WRITE("("); INV_A1; WRITE(")(");
                                INV_A2; WRITE(","); INV_A3; WRITE(","); INV_A4; WRITE(",");
                                INV_A5; WRITE(")"); break;
        case INDIRECT5_BIP: case INDIRECT5V_BIP:
                                WRITE("("); INV_A1; WRITE(")(");
                                INV_A2; WRITE(","); INV_A3; WRITE(","); INV_A4; WRITE(",");
                                INV_A5; WRITE(","); INV_A6; WRITE(")"); break;
        case MESSAGE0_BIP:      WRITE("("); INV_A1; WRITE("."); INV_A2; WRITE("())"); break;
        case MESSAGE1_BIP:      WRITE("("); INV_A1; WRITE("."); INV_A2; WRITE("(");
                                INV_A3; WRITE("))"); break;
        case MESSAGE2_BIP:      WRITE("("); INV_A1; WRITE("."); INV_A2; WRITE("(");
                                INV_A3; WRITE(","); INV_A4; WRITE("))"); break;
        case MESSAGE3_BIP:      WRITE("("); INV_A1; WRITE("."); INV_A2; WRITE("(");
                                INV_A3; WRITE(","); INV_A4; WRITE(","); INV_A5; WRITE("))"); break;
        case CALLMESSAGE0_BIP:  WRITE("("); INV_A1; WRITE(".call())"); break;
        case CALLMESSAGE1_BIP:  WRITE("("); INV_A1; WRITE(".call(");
                                INV_A2; WRITE("))"); break;
        case CALLMESSAGE2_BIP:  WRITE("("); INV_A1; WRITE(".call(");
                                INV_A2; WRITE(","); INV_A3; WRITE("))"); break;
        case CALLMESSAGE3_BIP:  WRITE("("); INV_A1; WRITE(".call(");
                                INV_A2; WRITE(","); INV_A3; WRITE(","); INV_A4; WRITE("))"); break;

        case SPACES_BIP:        WRITE("spaces "); INV_A1; break;
        case FONT_BIP:
            WRITE("if ("); INV_A1; WRITE(") { font on; } else { font off; }");
            suppress_terminal_semicolon = TRUE;
            break;
        case STYLEROMAN_BIP: WRITE("style roman"); break;
        case STYLEBOLD_BIP: WRITE("style bold"); break;
        case STYLEUNDERLINE_BIP: WRITE("style underline"); break;
        case STYLEREVERSE_BIP: WRITE("style reverse"); break;

        case MOVE_BIP: WRITE("move "); INV_A1; WRITE(" to "); INV_A2; break;
        case REMOVE_BIP: WRITE("remove "); INV_A1; break;
        case GIVE_BIP: WRITE("give "); INV_A1; WRITE(" "); INV_A2; break;
        case TAKE_BIP: WRITE("give "); INV_A1; WRITE(" ~"); INV_A2; break;

        case ALTERNATIVECASE_BIP: INV_A1; WRITE(", "); INV_A2; break;
        case SEQUENTIAL_BIP: WRITE("("); INV_A1; WRITE(","); INV_A2; WRITE(")"); break;
        case TERNARYSEQUENTIAL_BIP: Generate primitive for ternarysequential2.2; break;

        case PRINT_BIP: WRITE("print "); INV_A1_PRINTMODE; break;
        case PRINTRET_BIP: INV_A1_PRINTMODE; break;
        case PRINTCHAR_BIP: WRITE("print (char) "); INV_A1; break;
        case PRINTNAME_BIP: WRITE("print (name) "); INV_A1; break;
        case PRINTOBJ_BIP: WRITE("print (object) "); INV_A1; break;
        case PRINTPROPERTY_BIP: WRITE("print (property) "); INV_A1; break;
        case PRINTNUMBER_BIP: WRITE("print "); INV_A1; break;
        case PRINTADDRESS_BIP: WRITE("print (address) "); INV_A1; break;
        case PRINTSTRING_BIP: WRITE("print (string) "); INV_A1; break;
        case PRINTNLNUMBER_BIP: WRITE("print (number) "); INV_A1; break;
        case PRINTDEF_BIP: WRITE("print (the) "); INV_A1; break;
        case PRINTCDEF_BIP: WRITE("print (The) "); INV_A1; break;
        case PRINTINDEF_BIP: WRITE("print (a) "); INV_A1; break;
        case PRINTCINDEF_BIP: WRITE("print (A) "); INV_A1; break;
        case BOX_BIP: WRITE("box "); INV_A1_BOXMODE; break;

        case IF_BIP: Generate primitive for if2.3; break;
        case IFDEBUG_BIP: Generate primitive for ifdebug2.4; break;
        case IFSTRICT_BIP: Generate primitive for ifstrict2.5; break;
        case IFELSE_BIP: Generate primitive for ifelse2.6; break;
        case WHILE_BIP: Generate primitive for while2.7; break;
        case DO_BIP: Generate primitive for do2.8; break;
        case FOR_BIP: Generate primitive for for2.9; break;
        case OBJECTLOOP_BIP: Generate primitive for objectloop2.10; break;
        case OBJECTLOOPX_BIP: Generate primitive for objectloopx2.11; break;
        case LOOP_BIP: Generate primitive for loop2.12; break;
        case SWITCH_BIP: Generate primitive for switch2.13; break;
        case CASE_BIP: Generate primitive for case2.14; break;
        case DEFAULT_BIP: Generate primitive for default2.15; break;

        case RANDOM_BIP: WRITE("random("); INV_A1; WRITE(")"); break;

        case READ_BIP: WRITE("read "); INV_A1; WRITE(" "); INV_A2; break;

        default: LOG("Prim: %S\n", prim_name->symbol_name); internal_error("unimplemented prim");
    }
    return suppress_terminal_semicolon;
}

§2.1. Generate primitive for return2.1 =

    int rboolean = NOT_APPLICABLE;
    inter_tree_node *V = InterTree::first_child(P);
    if (V->W.data[ID_IFLD] == VAL_IST) {
        inter_ti val1 = V->W.data[VAL1_VAL_IFLD];
        inter_ti val2 = V->W.data[VAL2_VAL_IFLD];
        if (val1 == LITERAL_IVAL) {
            if (val2 == 0) rboolean = FALSE;
            if (val2 == 1) rboolean = TRUE;
        }
    }
    switch (rboolean) {
        case FALSE: WRITE("rfalse"); break;
        case TRUE: WRITE("rtrue"); break;
        case NOT_APPLICABLE: WRITE("return "); CodeGen::FC::frame(gen, V); break;
    }

This code is used in §2.

§2.2. Here we need some gymnastics. We need to produce a value which the sometimes shaky I6 expression parser will accept, which turns out to be quite a constraint. If we were compiling to C, we might try this:

    (a, b, c)

using the serial comma operator — that is, where the expression (a, b) evaluates a then b and returns the value of b, discarding a. Now I6 does support the comma operator, and this makes a workable scheme, right up to the point where some of the token values themselves include invocations of functions, because I6's syntax analyser won't always allow the serial comma to be mixed in the same expression with the function argument comma, i.e., I6 is unable properly to handle expressions like this one:

    (a(b, c), d)

where the first comma constructs a list and the second is the operator. (Many such expressions work fine, but not all.) That being so, the scheme I actually use is:

    (c) + 0*((b) + (a))

Because I6 evaluates the leaves in an expression tree right-to-left, not left-to-right, the parameter assignments happen first, then the conditions, then the result.

Generate primitive for ternarysequential2.2 =

    WRITE("(\n"); INDENT;
    WRITE("! This value evaluates third (i.e., last)\n"); INV_A3;
    OUTDENT; WRITE("+\n"); INDENT;
    WRITE("0*(\n"); INDENT;
    WRITE("! The following condition evaluates second\n");
    WRITE("((\n"); INDENT; INV_A2;
    OUTDENT; WRITE("\n))\n");
    OUTDENT; WRITE("+\n"); INDENT;
    WRITE("! The following assignments evaluate first\n");
    WRITE("("); INV_A1; WRITE(")");
    OUTDENT; WRITE(")\n");
    OUTDENT; WRITE(")\n");

This code is used in §2.

§2.3. Generate primitive for if2.3 =

    WRITE("if ("); INV_A1; WRITE(") {\n"); INDENT; INV_A2;
    OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.4. Generate primitive for ifdebug2.4 =

    WRITE("#ifdef DEBUG;\n"); INDENT; INV_A1; OUTDENT; WRITE("#endif;\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.5. Generate primitive for ifstrict2.5 =

    WRITE("#ifdef STRICT_MODE;\n"); INDENT; INV_A1; OUTDENT; WRITE("#endif;\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.6. Generate primitive for ifelse2.6 =

    WRITE("if ("); INV_A1; WRITE(") {\n"); INDENT; INV_A2; OUTDENT;
    WRITE("} else {\n"); INDENT; INV_A3; OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.7. Generate primitive for while2.7 =

    WRITE("while ("); INV_A1; WRITE(") {\n"); INDENT; INV_A2; OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.8. Generate primitive for do2.8 =

    WRITE("do {"); INV_A2; WRITE("} until (\n"); INDENT; INV_A1; OUTDENT; WRITE(")\n");

This code is used in §2.

§2.9. Generate primitive for for2.9 =

    WRITE("for (");
    inter_tree_node *INIT = InterTree::first_child(P);
    if (!((INIT->W.data[ID_IFLD] == VAL_IST) && (INIT->W.data[VAL1_VAL_IFLD] == LITERAL_IVAL) && (INIT->W.data[VAL2_VAL_IFLD] == 1))) INV_A1;
    WRITE(":"); INV_A2;
    WRITE(":");
    inter_tree_node *U = InterTree::third_child(P);
    if (U->W.data[ID_IFLD] != VAL_IST)
    CodeGen::FC::frame(gen, U);
    WRITE(") {\n"); INDENT; INV_A4;
    OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.10. Generate primitive for objectloop2.10 =

    int in_flag = FALSE;
    inter_tree_node *U = InterTree::third_child(P);
    if ((U->W.data[ID_IFLD] == INV_IST) && (U->W.data[METHOD_INV_IFLD] == INVOKED_PRIMITIVE)) {
        inter_symbol *prim = Inter::Inv::invokee(U);
        if ((prim) && (Primitives::to_bip(I, prim) == IN_BIP)) in_flag = TRUE;
    }

    WRITE("objectloop ");
    if (in_flag == FALSE) {
        WRITE("("); INV_A1; WRITE(" ofclass "); INV_A2;
        WRITE(" && ");
    } INV_A3;
    if (in_flag == FALSE) {
        WRITE(")");
    }
    WRITE(" {\n"); INDENT; INV_A4;
    OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.11. Generate primitive for objectloopx2.11 =

    WRITE("objectloop ("); INV_A1; WRITE(" ofclass "); INV_A2;
    WRITE(") {\n"); INDENT; INV_A3; OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.12. Generate primitive for loop2.12 =

    WRITE("{\n"); INDENT; INV_A1; OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.13. Generate primitive for switch2.13 =

    WRITE("switch ("); INV_A1;
    WRITE(") {\n"); INDENT; INV_A2; OUTDENT; WRITE("}\n");
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.14. Generate primitive for case2.14 =

    INV_A1; WRITE(":\n"); INDENT; INV_A2; WRITE(";\n"); OUTDENT;
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§2.15. Generate primitive for default2.15 =

    WRITE("default:\n"); INDENT; INV_A1; WRITE(";\n"); OUTDENT;
    suppress_terminal_semicolon = TRUE;

This code is used in §2.

§3.

void CodeGen::I6::compile_dictionary_word(code_generation_target *cgt, code_generation *gen,
    text_stream *S, int pluralise) {
    text_stream *OUT = CodeGen::current(gen);
    int n = 0;
    WRITE("'");
    LOOP_THROUGH_TEXT(pos, S) {
        wchar_t c = Str::get(pos);
        switch(c) {
            case '/': if (Str::len(S) == 1) WRITE("@{2F}"); else WRITE("/"); break;
            case '\'': WRITE("^"); break;
            case '^': WRITE("@{5E}"); break;
            case '~': WRITE("@{7E}"); break;
            case '@': WRITE("@{40}"); break;
            default: PUT(c);
        }
        if (n++ > 32) break;
    }
    if (pluralise) WRITE("//p");
    else if (Str::len(S) == 1) WRITE("//");
    WRITE("'");
}

§4.

void CodeGen::I6::compile_literal_number(code_generation_target *cgt,
    code_generation *gen, inter_ti val, int hex_mode) {
    text_stream *OUT = CodeGen::current(gen);
    if (hex_mode) WRITE("$%x", val);
    else WRITE("%d", val);
}

§5.

void CodeGen::I6::compile_literal_text(code_generation_target *cgt, code_generation *gen,
    text_stream *S, int printing_mode, int box_mode) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("\"");
    int esc_char = FALSE;
    LOOP_THROUGH_TEXT(pos, S) {
        wchar_t c = Str::get(pos);
        if (box_mode) {
            switch(c) {
                case '@': WRITE("@{40}"); break;
                case '"': WRITE("~"); break;
                case '^': WRITE("@{5E}"); break;
                case '~': WRITE("@{7E}"); break;
                case '\\': WRITE("@{5C}"); break;
                case '\t': WRITE(" "); break;
                case '\n': WRITE("\"\n\""); break;
                case NEWLINE_IN_STRING: WRITE("\"\n\""); break;
                default: PUT(c);
            }
        } else {
            switch(c) {
                case '@':
                    if (printing_mode) {
                        WRITE("@@64"); esc_char = TRUE; continue;
                    }
                    WRITE("@{40}"); break;
                case '"': WRITE("~"); break;
                case '^':
                    if (printing_mode) {
                        WRITE("@@94"); esc_char = TRUE; continue;
                    }
                    WRITE("@{5E}"); break;
                case '~':
                    if (printing_mode) {
                        WRITE("@@126"); esc_char = TRUE; continue;
                    }
                    WRITE("@{7E}"); break;
                case '\\': WRITE("@{5C}"); break;
                case '\t': WRITE(" "); break;
                case '\n': WRITE("^"); break;
                case NEWLINE_IN_STRING: WRITE("^"); break;
                default: {
                    if (esc_char) WRITE("@{%02x}", c);
                    else PUT(c);
                }
            }
            esc_char = FALSE;
        }
    }
    WRITE("\"");
}

§6. Because in I6 source code some properties aren't declared before use, it follows that if not used by any object then they won't ever be created. This is a problem since it means that I6 code can't refer to them, because it would need to mention an I6 symbol which doesn't exist. To get around this, we create the property names which don't exist as constant symbols with the harmless value 0; we do this right at the end of the compiled I6 code. (This is a standard I6 trick called "stubbing", these being "stub definitions".)

void CodeGen::I6::declare_property(code_generation_target *cgt, code_generation *gen,
    inter_symbol *prop_name, int used) {
    text_stream *name = CodeGen::CL::name(prop_name);
    if (used) {
        generated_segment *saved = CodeGen::select(gen, predeclarations_I7CGS);
        WRITE_TO(CodeGen::current(gen), "Property %S;\n", prop_name->symbol_name);
        CodeGen::deselect(gen, saved);
    } else {
        generated_segment *saved = CodeGen::select(gen, code_at_eof_I7CGS);
        WRITE_TO(CodeGen::current(gen), "#ifndef %S; Constant %S = 0; #endif;\n", name, name);
        CodeGen::deselect(gen, saved);
    }
}

void CodeGen::I6::declare_attribute(code_generation_target *cgt, code_generation *gen,
    text_stream *prop_name) {
    WRITE_TO(CodeGen::current(gen), "Attribute %S;\n", prop_name);
}

void CodeGen::I6::property_offset(code_generation_target *cgt, code_generation *gen, text_stream *prop, int pos, int as_attr) {
    generated_segment *saved = CodeGen::select(gen, property_offset_creator_I7CGS);
    text_stream *OUT = CodeGen::current(gen);
    if (I6_property_offsets_made++ == 0) {
        WRITE("[ CreatePropertyOffsets i;\n"); INDENT;
        WRITE("for (i=0: i<attributed_property_offsets_SIZE: i++)\n"); INDENT;
        WRITE("attributed_property_offsets-->i = -1;\n"); OUTDENT;
        WRITE("for (i=0: i<valued_property_offsets_SIZE: i++)\n"); INDENT;
        WRITE("valued_property_offsets-->i = -1;\n"); OUTDENT;
    }
    if (as_attr) WRITE("attributed_property_offsets");
    else WRITE("valued_property_offsets");
    WRITE("-->%S = %d;\n", prop, pos);
    CodeGen::deselect(gen, saved);
}

§7.

int CodeGen::I6::prepare_variable(code_generation_target *cgt, code_generation *gen,
    inter_tree_node *P, inter_symbol *var_name, int k) {
    if (Inter::Symbols::read_annotation(var_name, EXPLICIT_VARIABLE_IANN) != 1) {
        if (Inter::Symbols::read_annotation(var_name, ASSIMILATED_IANN) != 1) {
            text_stream *S = Str::new();
            WRITE_TO(S, "(Global_Vars-->%d)", k);
            Inter::Symbols::set_translate(var_name, S);
        }
        k++;
    }
    return k;
}

int CodeGen::I6::declare_variable(code_generation_target *cgt, code_generation *gen,
    inter_tree_node *P, inter_symbol *var_name, int k, int of) {
    if (Inter::Symbols::read_annotation(var_name, ASSIMILATED_IANN) == 1) {
        generated_segment *saved = CodeGen::select(gen, main_matter_I7CGS);
        text_stream *OUT = CodeGen::current(gen);
        WRITE("Global %S = ", CodeGen::CL::name(var_name));
        CodeGen::CL::literal(gen, NULL, Inter::Packages::scope_of(P), P->W.data[VAL1_VAR_IFLD], P->W.data[VAL2_VAR_IFLD], FALSE);
        WRITE(";\n");
        CodeGen::deselect(gen, saved);
    }
    if (Inter::Symbols::read_annotation(var_name, EXPLICIT_VARIABLE_IANN) != 1) {
        generated_segment *saved = CodeGen::select(gen, predeclarations_I7CGS);
        text_stream *OUT = CodeGen::current(gen);
        if (k == 0) WRITE("Array Global_Vars -->\n");
        WRITE("  (");
        inter_symbols_table *globals = Inter::Packages::scope_of(P);
        CodeGen::CL::literal(gen, NULL, globals, P->W.data[VAL1_VAR_IFLD], P->W.data[VAL2_VAR_IFLD], FALSE);
        WRITE(") ! -->%d = %S (%S)\n", k, CodeGen::CL::name(var_name), var_name->symbol_name);
        k++;
        if (k == of) {
            if (k < 2) WRITE("  NULL NULL");
            WRITE(";\n");
        }
        CodeGen::deselect(gen, saved);
    }
    return k;
}

void CodeGen::I6::declare_class(code_generation_target *cgt, code_generation *gen, text_stream *class_name) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("Class %S\n", class_name);
}

void CodeGen::I6::end_class(code_generation_target *cgt, code_generation *gen, text_stream *class_name) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(";\n");
}

void CodeGen::I6::declare_instance(code_generation_target *cgt, code_generation *gen, text_stream *class_name, text_stream *instance_name) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("%S %S", class_name, instance_name);
}

void CodeGen::I6::end_instance(code_generation_target *cgt, code_generation *gen, text_stream *class_name, text_stream *instance_name) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(";\n");
}

void CodeGen::I6::assign_property(code_generation_target *cgt, code_generation *gen, text_stream *property_name, text_stream *val, int as_att) {
    text_stream *OUT = CodeGen::current(gen);
    if (as_att) {
        if (Str::eq(val, I"0")) WRITE("    has ~%S\n", property_name);
        else WRITE("    has %S\n", property_name);
    } else {
        WRITE("    with %S %S\n", property_name, val);
    }
}

void CodeGen::I6::declare_local_variable(code_generation_target *cgt, int pass,
    code_generation *gen, inter_tree_node *P, inter_symbol *var_name) {
    if (pass == 2) {
        text_stream *OUT = CodeGen::current(gen);
        WRITE(" %S", var_name->symbol_name);
    }
}

void CodeGen::I6::begin_constant(code_generation_target *cgt, code_generation *gen, text_stream *const_name, int continues, int ifndef_me) {
    text_stream *OUT = CodeGen::current(gen);
    if (ifndef_me) WRITE("#ifndef %S;\n", const_name);
    WRITE("Constant %S", const_name);
    if (continues) WRITE(" = ");
}
void CodeGen::I6::end_constant(code_generation_target *cgt, code_generation *gen, text_stream *const_name, int ifndef_me) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(";\n");
    if (ifndef_me) WRITE("#endif;\n");
}

void CodeGen::I6::begin_function(code_generation_target *cgt, int pass, code_generation *gen, inter_symbol *fn) {
    text_stream *fn_name = CodeGen::CL::name(fn);
    if (pass == 2) {
        text_stream *OUT = CodeGen::current(gen);
        WRITE("[ %S", fn_name);
    }
}
void CodeGen::I6::begin_function_code(code_generation_target *cgt, code_generation *gen) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(";");
}
void CodeGen::I6::place_label(code_generation_target *cgt, code_generation *gen, text_stream *label_name) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("%S;\n", label_name);
}
void CodeGen::I6::end_function(code_generation_target *cgt, int pass, code_generation *gen, inter_symbol *fn) {
    if (pass == 2) {
        text_stream *OUT = CodeGen::current(gen);
        WRITE("];\n");
    }
}

void CodeGen::I6::begin_function_call(code_generation_target *cgt, code_generation *gen, inter_symbol *fn, int argc) {
    text_stream *fn_name = CodeGen::CL::name(fn);
    text_stream *OUT = CodeGen::current(gen);
    WRITE("%S(", fn_name);
}
void CodeGen::I6::argument(code_generation_target *cgt, code_generation *gen, inter_tree_node *F, inter_symbol *fn, int argc, int of_argc) {
    text_stream *OUT = CodeGen::current(gen);
    if (argc > 0) WRITE(", ");
    CodeGen::FC::frame(gen, F);
}
void CodeGen::I6::end_function_call(code_generation_target *cgt, code_generation *gen, inter_symbol *fn, int argc) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(")");
}

void CodeGen::I6::begin_opcode(code_generation_target *cgt, code_generation *gen, text_stream *opcode) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("%S", opcode);
}
void CodeGen::I6::supply_operand(code_generation_target *cgt, code_generation *gen, inter_tree_node *F, int is_label) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(" ");
    if (is_label) WRITE("?");
    CodeGen::FC::frame(gen, F);
}
void CodeGen::I6::end_opcode(code_generation_target *cgt, code_generation *gen) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(";");
}

void CodeGen::I6::begin_array(code_generation_target *cgt, code_generation *gen, text_stream *array_name, int format) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("Array %S ", array_name);
    switch (format) {
        case WORD_ARRAY_FORMAT: WRITE("-->"); break;
        case BYTE_ARRAY_FORMAT: WRITE("->"); break;
        case TABLE_ARRAY_FORMAT: WRITE("table"); break;
        case BUFFER_ARRAY_FORMAT: WRITE("buffer"); break;
    }
}

void CodeGen::I6::array_entry(code_generation_target *cgt, code_generation *gen, text_stream *entry, int format) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(" (%S)", entry);
}

void CodeGen::I6::end_array(code_generation_target *cgt, code_generation *gen, int format) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE(";\n");
}

void CodeGen::I6::new_fake_action(code_generation_target *cgt, code_generation *gen, text_stream *name) {
    text_stream *OUT = CodeGen::current(gen);
    WRITE("Fake_Action %S;\n", name);
}