5 * Permission is hereby granted, free of charge, to any person obtaining a copy of
6 * this software and associated documentation files (the "Software"), to deal in
7 * the Software without restriction, including without limitation the rights to
8 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
9 * of the Software, and to permit persons to whom the Software is furnished to do
10 * so, subject to the following conditions:
12 * The above copyright notice and this permission notice shall be included in all
13 * copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
30 #define ast_instantiate(T, ctx, destroyfn) \
31 T* self = (T*)mem_a(sizeof(T)); \
35 ast_node_init((ast_node*)self, ctx); \
36 ( (ast_node*)self )->node.destroy = (ast_node_delete*)destroyfn
38 /* It must not be possible to get here. */
39 static void _ast_node_destroy(ast_node *self)
41 fprintf(stderr, "ast node missing destroy()\n");
45 /* Initialize main ast node aprts */
46 static void ast_node_init(ast_node *self, lex_ctx ctx)
48 self->node.context = ctx;
49 self->node.destroy = &_ast_node_destroy;
50 self->node.keep = false;
53 /* General expression initialization */
54 static void ast_expression_init(ast_expression *self,
55 ast_expression_codegen *codegen)
57 self->expression.codegen = codegen;
58 self->expression.vtype = TYPE_VOID;
59 self->expression.next = NULL;
62 static void ast_expression_delete(ast_expression *self)
64 if (self->expression.next)
65 ast_delete(self->expression.next);
68 static void ast_expression_delete_full(ast_expression *self)
70 ast_expression_delete(self);
74 static ast_expression* ast_type_copy(lex_ctx ctx, const ast_expression *ex)
76 const ast_expression_common *cpex;
77 ast_expression_common *selfex;
83 ast_instantiate(ast_expression, ctx, ast_expression_delete_full);
85 cpex = &ex->expression;
86 selfex = &self->expression;
88 selfex->vtype = cpex->vtype;
91 selfex->next = ast_type_copy(ctx, cpex->next);
100 /* This may never be codegen()d */
101 selfex->codegen = NULL;
106 ast_value* ast_value_new(lex_ctx ctx, const char *name, int t)
108 ast_instantiate(ast_value, ctx, ast_value_delete);
109 ast_expression_init((ast_expression*)self,
110 (ast_expression_codegen*)&ast_value_codegen);
111 self->expression.node.keep = true; /* keep */
113 self->name = name ? util_strdup(name) : NULL;
114 self->expression.vtype = t;
115 self->expression.next = NULL;
116 MEM_VECTOR_INIT(self, params);
117 self->isconst = false;
118 memset(&self->constval, 0, sizeof(self->constval));
124 MEM_VEC_FUNCTIONS(ast_value, ast_value*, params)
126 void ast_value_delete(ast_value* self)
130 mem_d((void*)self->name);
131 for (i = 0; i < self->params_count; ++i)
132 ast_value_delete(self->params[i]); /* delete, the ast_function is expected to die first */
133 MEM_VECTOR_CLEAR(self, params);
135 switch (self->expression.vtype)
138 mem_d((void*)self->constval.vstring);
141 /* unlink us from the function node */
142 self->constval.vfunc->vtype = NULL;
144 /* NOTE: delete function? currently collected in
145 * the parser structure
151 ast_expression_delete((ast_expression*)self);
155 bool ast_value_set_name(ast_value *self, const char *name)
158 mem_d((void*)self->name);
159 self->name = util_strdup(name);
163 ast_binary* ast_binary_new(lex_ctx ctx, int op,
164 ast_expression* left, ast_expression* right)
166 ast_instantiate(ast_binary, ctx, ast_binary_delete);
167 ast_expression_init((ast_expression*)self, (ast_expression_codegen*)&ast_binary_codegen);
176 void ast_binary_delete(ast_binary *self)
178 ast_unref(self->left);
179 ast_unref(self->right);
180 ast_expression_delete((ast_expression*)self);
184 ast_entfield* ast_entfield_new(lex_ctx ctx, ast_expression *entity, ast_expression *field)
186 const ast_expression *outtype;
188 ast_instantiate(ast_entfield, ctx, ast_entfield_delete);
190 if (field->expression.vtype != TYPE_FIELD) {
195 outtype = field->expression.next;
198 /* Error: field has no type... */
202 ast_expression_init((ast_expression*)self, (ast_expression_codegen*)&ast_entfield_codegen);
204 self->expression.vtype = outtype->expression.vtype;
205 self->expression.next = ast_type_copy(ctx, outtype->expression.next);
207 self->entity = entity;
213 void ast_entfield_delete(ast_entfield *self)
215 ast_unref(self->entity);
216 ast_unref(self->field);
217 ast_expression_delete((ast_expression*)self);
221 ast_ifthen* ast_ifthen_new(lex_ctx ctx, ast_expression *cond, ast_expression *ontrue, ast_expression *onfalse)
223 ast_instantiate(ast_ifthen, ctx, ast_ifthen_delete);
224 if (!ontrue && !onfalse) {
225 /* because it is invalid */
229 ast_expression_init((ast_expression*)self, (ast_expression_codegen*)&ast_ifthen_codegen);
232 self->on_true = ontrue;
233 self->on_false = onfalse;
238 void ast_ifthen_delete(ast_ifthen *self)
240 ast_unref(self->cond);
241 ast_unref(self->on_true);
242 ast_unref(self->on_false);
243 ast_expression_delete((ast_expression*)self);
247 ast_ternary* ast_ternary_new(lex_ctx ctx, ast_expression *cond, ast_expression *ontrue, ast_expression *onfalse)
249 ast_instantiate(ast_ternary, ctx, ast_ternary_delete);
250 /* This time NEITHER must be NULL */
251 if (!ontrue || !onfalse) {
255 ast_expression_init((ast_expression*)self, (ast_expression_codegen*)&ast_ternary_codegen);
258 self->on_true = ontrue;
259 self->on_false = onfalse;
260 self->phi_out = NULL;
265 void ast_ternary_delete(ast_ternary *self)
267 ast_unref(self->cond);
268 ast_unref(self->on_true);
269 ast_unref(self->on_false);
270 ast_expression_delete((ast_expression*)self);
274 ast_store* ast_store_new(lex_ctx ctx, int op,
275 ast_value *dest, ast_expression *source)
277 ast_instantiate(ast_store, ctx, ast_store_delete);
278 ast_expression_init((ast_expression*)self, (ast_expression_codegen*)&ast_store_codegen);
282 self->source = source;
287 void ast_store_delete(ast_store *self)
289 ast_unref(self->dest);
290 ast_unref(self->source);
291 ast_expression_delete((ast_expression*)self);
295 ast_block* ast_block_new(lex_ctx ctx)
297 ast_instantiate(ast_block, ctx, ast_block_delete);
298 ast_expression_init((ast_expression*)self,
299 (ast_expression_codegen*)&ast_block_codegen);
301 MEM_VECTOR_INIT(self, locals);
302 MEM_VECTOR_INIT(self, exprs);
306 MEM_VEC_FUNCTIONS(ast_block, ast_value*, locals)
307 MEM_VEC_FUNCTIONS(ast_block, ast_expression*, exprs)
309 void ast_block_delete(ast_block *self)
312 for (i = 0; i < self->exprs_count; ++i)
313 ast_unref(self->exprs[i]);
314 MEM_VECTOR_CLEAR(self, exprs);
315 for (i = 0; i < self->locals_count; ++i)
316 ast_delete(self->locals[i]);
317 MEM_VECTOR_CLEAR(self, locals);
318 ast_expression_delete((ast_expression*)self);
322 ast_function* ast_function_new(lex_ctx ctx, const char *name, ast_value *vtype)
324 ast_instantiate(ast_function, ctx, ast_function_delete);
328 vtype->expression.vtype != TYPE_FUNCTION)
335 self->name = name ? util_strdup(name) : NULL;
336 MEM_VECTOR_INIT(self, blocks);
338 self->labelcount = 0;
340 self->ir_func = NULL;
341 self->curblock = NULL;
343 vtype->isconst = true;
344 vtype->constval.vfunc = self;
349 MEM_VEC_FUNCTIONS(ast_function, ast_block*, blocks)
351 void ast_function_delete(ast_function *self)
355 mem_d((void*)self->name);
357 /* ast_value_delete(self->vtype); */
358 self->vtype->isconst = false;
359 self->vtype->constval.vfunc = NULL;
360 /* We use unref - if it was stored in a global table it is supposed
361 * to be deleted from *there*
363 ast_unref(self->vtype);
365 for (i = 0; i < self->blocks_count; ++i)
366 ast_delete(self->blocks[i]);
367 MEM_VECTOR_CLEAR(self, blocks);
371 static void ast_util_hexitoa(char *buf, size_t size, unsigned int num)
373 unsigned int base = 10;
374 #define checknul() do { if (size == 1) { *buf = 0; return; } } while (0)
375 #define addch(x) do { *buf++ = (x); --size; checknul(); } while (0)
384 int digit = num % base;
395 const char* ast_function_label(ast_function *self, const char *prefix)
397 size_t id = (self->labelcount++);
398 size_t len = strlen(prefix);
399 strncpy(self->labelbuf, prefix, sizeof(self->labelbuf));
400 ast_util_hexitoa(self->labelbuf + len, sizeof(self->labelbuf)-len, id);
401 return self->labelbuf;
404 /*********************************************************************/
406 * by convention you must never pass NULL to the 'ir_value **out'
407 * parameter. If you really don't care about the output, pass a dummy.
408 * But I can't imagine a pituation where the output is truly unnecessary.
411 bool ast_value_codegen(ast_value *self, ast_function *func, bool lvalue, ir_value **out)
413 /* NOTE: This is the codegen for a variable used in an expression.
414 * It is not the codegen to generate the value. For this purpose,
415 * ast_local_codegen and ast_global_codegen are to be used before this
416 * is executed. ast_function_codegen should take care of its locals,
417 * and the ast-user should take care of ast_global_codegen to be used
418 * on all the globals.
426 bool ast_global_codegen(ast_value *self, ir_builder *ir)
429 if (self->isconst && self->expression.vtype == TYPE_FUNCTION)
431 ir_function *func = ir_builder_create_function(ir, self->name);
435 self->constval.vfunc->ir_func = func;
436 /* The function is filled later on ast_function_codegen... */
440 v = ir_builder_create_global(ir, self->name, self->expression.vtype);
445 switch (self->expression.vtype)
448 if (!ir_value_set_float(v, self->constval.vfloat))
452 if (!ir_value_set_vector(v, self->constval.vvec))
456 if (!ir_value_set_string(v, self->constval.vstring))
460 /* Cannot generate an IR value for a function,
461 * need a pointer pointing to a function rather.
465 printf("TODO: global constant type %i\n", self->expression.vtype);
470 /* link us to the ir_value */
474 error: /* clean up */
479 bool ast_local_codegen(ast_value *self, ir_function *func)
482 if (self->isconst && self->expression.vtype == TYPE_FUNCTION)
484 /* Do we allow local functions? I think not...
485 * this is NOT a function pointer atm.
490 v = ir_function_create_local(func, self->name, self->expression.vtype);
494 /* A constant local... hmmm...
495 * I suppose the IR will have to deal with this
498 switch (self->expression.vtype)
501 if (!ir_value_set_float(v, self->constval.vfloat))
505 if (!ir_value_set_vector(v, self->constval.vvec))
509 if (!ir_value_set_string(v, self->constval.vstring))
513 printf("TODO: global constant type %i\n", self->expression.vtype);
518 /* link us to the ir_value */
522 error: /* clean up */
527 bool ast_function_codegen(ast_function *self, ir_builder *ir)
535 printf("ast_function's related ast_value was not generated yet\n");
539 self->curblock = ir_function_create_block(irf, "entry");
543 for (i = 0; i < self->blocks_count; ++i) {
544 ast_expression_codegen *gen = self->blocks[i]->expression.codegen;
545 if (!(*gen)((ast_expression*)self->blocks[i], self, false, &dummy))
549 /* TODO: check return types */
550 if (!self->curblock->is_return)
552 if (!self->vtype->expression.next ||
553 self->vtype->expression.next->expression.vtype == TYPE_VOID)
554 return ir_block_create_return(self->curblock, NULL);
557 /* error("missing return"); */
564 /* Note, you will not see ast_block_codegen generate ir_blocks.
565 * To the AST and the IR, blocks are 2 different things.
566 * In the AST it represents a block of code, usually enclosed in
567 * curly braces {...}.
568 * While in the IR it represents a block in terms of control-flow.
570 bool ast_block_codegen(ast_block *self, ast_function *func, bool lvalue, ir_value **out)
575 * Note: an ast-representation using the comma-operator
576 * of the form: (a, b, c) = x should not assign to c...
580 /* output is NULL at first, we'll have each expression
581 * assign to out output, thus, a comma-operator represention
582 * using an ast_block will return the last generated value,
583 * so: (b, c) + a executed both b and c, and returns c,
584 * which is then added to a.
588 /* generate locals */
589 for (i = 0; i < self->locals_count; ++i)
591 if (!ast_local_codegen(self->locals[i], func->ir_func))
595 for (i = 0; i < self->exprs_count; ++i)
597 ast_expression_codegen *gen = self->exprs[i]->expression.codegen;
598 if (!(*gen)(self->exprs[i], func, false, out))
605 bool ast_store_codegen(ast_store *self, ast_function *func, bool lvalue, ir_value **out)
607 ast_expression_codegen *cgen;
608 ir_value *left, *right;
610 cgen = self->dest->expression.codegen;
612 if (!(*cgen)((ast_expression*)(self->dest), func, true, &left))
615 cgen = self->source->expression.codegen;
617 if (!(*cgen)((ast_expression*)(self->source), func, false, &right))
620 if (!ir_block_create_store_op(func->curblock, self->op, left, right))
623 /* Theoretically, an assinment returns its left side as an
624 * lvalue, if we don't need an lvalue though, we return
625 * the right side as an rvalue, otherwise we have to
626 * somehow know whether or not we need to dereference the pointer
627 * on the left side - that is: OP_LOAD if it was an address.
628 * Also: in original QC we cannot OP_LOADP *anyway*.
630 *out = (lvalue ? left : right);
635 bool ast_binary_codegen(ast_binary *self, ast_function *func, bool lvalue, ir_value **out)
637 ast_expression_codegen *cgen;
638 ir_value *left, *right;
640 /* In the context of a binary operation, we can disregard
645 cgen = self->left->expression.codegen;
647 if (!(*cgen)((ast_expression*)(self->left), func, false, &left))
650 cgen = self->right->expression.codegen;
652 if (!(*cgen)((ast_expression*)(self->right), func, false, &right))
655 *out = ir_block_create_binop(func->curblock, ast_function_label(func, "bin"),
656 self->op, left, right);
663 bool ast_entfield_codegen(ast_entfield *self, ast_function *func, bool lvalue, ir_value **out)
665 ast_expression_codegen *cgen;
666 ir_value *ent, *field;
668 /* This function needs to take the 'lvalue' flag into account!
669 * As lvalue we provide a field-pointer, as rvalue we provide the
673 cgen = self->entity->expression.codegen;
674 if (!(*cgen)((ast_expression*)(self->entity), func, false, &ent))
677 cgen = self->field->expression.codegen;
678 if (!(*cgen)((ast_expression*)(self->field), func, false, &field))
683 *out = ir_block_create_fieldaddress(func->curblock, ast_function_label(func, "efa"),
686 *out = ir_block_create_load_from_ent(func->curblock, ast_function_label(func, "efv"),
687 ent, field, self->expression.vtype);
692 /* Hm that should be it... */
696 bool ast_ifthen_codegen(ast_ifthen *self, ast_function *func, bool lvalue, ir_value **out)
698 ast_expression_codegen *cgen;
703 ir_block *cond = func->curblock;
708 /* We don't output any value, thus also don't care about r/lvalue */
712 /* create blocks first, it's nicer if they're ordered */
715 /* create on-true block */
716 ontrue = ir_function_create_block(func->ir_func, ast_function_label(func, "ontrue"));
722 if (self->on_false) {
723 /* create on-false block */
724 onfalse = ir_function_create_block(func->ir_func, ast_function_label(func, "onfalse"));
730 merge = ir_function_create_block(func->ir_func, ast_function_label(func, "endif"));
734 /* generate the condition */
735 func->curblock = cond;
736 cgen = self->cond->expression.codegen;
737 if (!(*cgen)((ast_expression*)(self->cond), func, false, &condval))
740 if (!ir_block_create_if(cond, condval,
741 (ontrue ? ontrue : merge),
742 (onfalse ? onfalse : merge)))
749 /* enter the block */
750 func->curblock = ontrue;
753 cgen = self->on_true->expression.codegen;
754 if (!(*cgen)((ast_expression*)(self->on_true), func, false, &dummy))
757 /* jump to merge block */
758 if (!ir_block_create_jump(ontrue, merge))
764 /* enter the block */
765 func->curblock = onfalse;
768 cgen = self->on_false->expression.codegen;
769 if (!(*cgen)((ast_expression*)(self->on_false), func, false, &dummy))
772 /* jump to merge block */
773 if (!ir_block_create_jump(ontrue, merge))
777 /* Now enter the merge block */
778 func->curblock = merge;
783 bool ast_ternary_codegen(ast_ternary *self, ast_function *func, bool lvalue, ir_value **out)
785 ast_expression_codegen *cgen;
788 ir_value *trueval, *falseval;
791 ir_block *cond = func->curblock;
796 /* In theory it shouldn't be possible to pass through a node twice, but
797 * in case we add any kind of optimization pass for the AST itself, it
798 * may still happen, thus we remember a created ir_value and simply return one
799 * if it already exists.
802 *out = self->phi_out;
806 /* Ternary can never create an lvalue... */
810 /* In the following, contraty to ast_ifthen, we assume both paths exist. */
812 /* create on-true block */
813 ontrue = ir_function_create_block(func->ir_func, ast_function_label(func, "tern_T"));
817 /* create on-false block */
818 onfalse = ir_function_create_block(func->ir_func, ast_function_label(func, "tern_F"));
822 merge = ir_function_create_block(func->ir_func, ast_function_label(func, "tern_out"));
826 /* generate the condition */
827 func->curblock = cond;
828 cgen = self->cond->expression.codegen;
829 if (!(*cgen)((ast_expression*)(self->cond), func, false, &condval))
832 if (!ir_block_create_if(cond, condval, ontrue, onfalse))
836 /* enter the block */
837 func->curblock = ontrue;
840 cgen = self->on_true->expression.codegen;
841 if (!(*cgen)((ast_expression*)(self->on_true), func, false, &trueval))
844 /* jump to merge block */
845 if (!ir_block_create_jump(ontrue, merge))
849 /* enter the block */
850 func->curblock = onfalse;
853 cgen = self->on_false->expression.codegen;
854 if (!(*cgen)((ast_expression*)(self->on_false), func, false, &falseval))
857 /* jump to merge block */
858 if (!ir_block_create_jump(ontrue, merge))
861 /* Now enter the merge block */
862 func->curblock = merge;
864 /* Here, now, we need a PHI node
865 * but first some sanity checking...
867 if (trueval->vtype != falseval->vtype) {
868 /* error("ternary with different types on the two sides"); */
873 phi = ir_block_create_phi(merge, ast_function_label(func, "phi"), trueval->vtype);
875 !ir_phi_add(phi, ontrue, trueval) ||
876 !ir_phi_add(phi, onfalse, falseval))
881 self->phi_out = ir_phi_value(phi);
882 *out = self->phi_out;