3 MPSL - Minimum Profit Scripting Language
4 Copyright (C) 2003/2010 Angel Ortega <angel@triptico.com>
6 mpsl_c.c - Minimum Profit Scripting Language Core
8 This program is free software; you can redistribute it and/or
9 modify it under the terms of the GNU General Public License
10 as published by the Free Software Foundation; either version 2
11 of the License, or (at your option) any later version.
13 This program 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 this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
22 http://www.triptico.com
37 /* global abort flag */
40 /* temporary storage for the opcode table
41 (only usable while compiling) */
42 mpdm_t mpsl_opcodes
= NULL
;
44 /* pointer to a trap function */
45 static mpdm_t mpsl_trap_func
= NULL
;
51 * mpsl_is_true - Tests if a value is true.
54 * If @v is a valid MPSL 'false' value (NULL, "" or the "0" string),
55 * returns zero, or nonzero otherwise.
57 int mpsl_is_true(mpdm_t v
)
59 /* if value is NULL, it's false */
63 /* if it's a printable string... */
64 if (v
->flags
& MPDM_STRING
) {
65 wchar_t *ptr
= mpdm_string(v
);
67 /* ... and it's "" or the "0" string, it's false */
68 if (*ptr
== L
'\0' || (*ptr
== L
'0' && *(ptr
+ 1) == L
'\0'))
72 /* any other case is true */
78 * mpsl_boolean - Returns 'true' or 'false' MPSL stock values.
79 * @b: boolean selector
81 * Returns MPSL's 'false' or 'true' values depending on the value in @b.
83 mpdm_t
mpsl_boolean(int b
)
85 return b
? mpdm_hget_s(mpdm_root(), L
"TRUE") : NULL
;
89 static mpdm_t
find_local_symtbl(mpdm_t s
, mpdm_t l
)
90 /* finds the local symbol table hash that holds l */
95 /* no local symbol table? nothing to find */
99 /* if s is multiple, take just the first element */
100 if (MPDM_IS_ARRAY(s
))
103 /* travel the local symbol table trying to find it */
104 for (n
= mpdm_size(l
) - 1; n
>= 0; n
--) {
105 mpdm_t h
= mpdm_aget(l
, n
);
107 if (mpdm_exists(h
, s
)) {
117 static void set_local_symbols(mpdm_t s
, mpdm_t v
, mpdm_t l
)
118 /* sets (or creates) a list of local symbols with a list of values */
127 /* gets the top local variable frame */
128 h
= mpdm_aget(l
, -1);
130 if (MPDM_IS_ARRAY(s
) || MPDM_IS_ARRAY(v
)) {
134 for (n
= 0; n
< mpdm_size(s
); n
++)
135 mpdm_hset(h
, mpdm_aget(s
, n
), mpdm_aget(v
, n
));
137 if (n
< mpdm_size(v
)) {
138 /* store the rest of arguments into _ */
139 a
= mpdm_hset_s(h
, L
"_", MPDM_A(0));
141 for (; n
< mpdm_size(v
); n
++)
142 mpdm_push(a
, mpdm_aget(v
, n
));
156 * mpsl_set_symbol - Sets value to a symbol.
159 * @l: local symbol table
161 * Assigns the value @v to the @s symbol. If the value exists as
162 * a local symbol, it's assigned to it; otherwise, it's set as a global
163 * symbol (and created if it does not exist).
165 mpdm_t
mpsl_set_symbol(mpdm_t s
, mpdm_t v
, mpdm_t l
)
173 r
= mpdm_sset(find_local_symtbl(s
, l
), s
, v
);
183 mpdm_t
mpsl_get_symbol_i(mpdm_t s
, mpdm_t l
, int i
)
190 r
= mpdm_sget_i(find_local_symtbl(s
, l
), s
, i
);
200 * mpsl_get_symbol - Gets the value of a symbol.
202 * @l: local symbol table
204 * Gets the value of a symbol. The symbol can be local or global
205 * (if the symbol exists in both tables, the local value will be returned).
207 mpdm_t
mpsl_get_symbol(mpdm_t s
, mpdm_t l
)
209 return mpsl_get_symbol_i(s
, l
, 0);
214 * mpsl_error - Generates an error.
215 * @err: the error message
217 * Generates an error. The @err error message is stored in the ERROR
218 * mpsl variable and the mpsl_abort global flag is set, so no further
219 * mpsl code can be executed until reset.
221 mpdm_t
mpsl_error(mpdm_t err
)
223 /* abort further execution */
227 return mpdm_hset_s(mpdm_root(), L
"ERROR", err
);
231 /** opcode macro helpers **/
233 #define O_TYPE static mpdm_t
234 #define O_ARGS mpdm_t c, mpdm_t a, mpdm_t l, int * f
236 O_TYPE
mpsl_exec_i(O_ARGS
);
238 #define C(n) mpdm_aget(c, n)
242 #define M(n) mpsl_exec_i(C(n), a, l, f)
248 #define R(x) mpdm_rval(x)
249 #define I(x) mpdm_ival(x)
251 #define RM1 mpdm_rval(M(1))
252 #define RM2 mpdm_rval(M(2))
253 #define IM1 mpdm_ival(M(1))
254 #define IM2 mpdm_ival(M(2))
256 #define GET(m) mpsl_get_symbol(m, l)
257 #define SET(m, v) mpsl_set_symbol(m, v, l)
258 #define BOOL mpsl_boolean
260 #define RF(v) mpdm_ref(v)
261 #define UF(v) v = mpdm_unref(v)
262 #define UFND(v) mpdm_unrefnd(v)
264 static int is_true_uf(mpdm_t v
)
277 O_TYPE
O_literal(O_ARGS
)
279 return mpdm_clone(C1
);
282 O_TYPE
O_multi(O_ARGS
)
294 O_TYPE
O_imulti(O_ARGS
)
304 O_TYPE
O_symval(O_ARGS
)
309 O_TYPE
O_assign(O_ARGS
)
316 return is_true_uf(M1
) ? M2
: M3
;
319 O_TYPE
O_local(O_ARGS
)
321 set_local_symbols(M1
, NULL
, l
);
326 O_TYPE
O_uminus(O_ARGS
)
328 return MPDM_R(-mpdm_rval(M1
));
333 return MPDM_R(RM1
+ RM2
);
338 return MPDM_R(RM1
- RM2
);
343 return MPDM_R(RM1
* RM2
);
348 return MPDM_R(RM1
/ RM2
);
353 return MPDM_I(IM1
% IM2
);
358 return BOOL(!is_true_uf(M1
));
366 if (mpsl_is_true(v
)) {
381 if (!mpsl_is_true(v
)) {
391 O_TYPE
O_bitand(O_ARGS
)
393 return MPDM_I(IM1
& IM2
);
396 O_TYPE
O_bitor(O_ARGS
)
398 return MPDM_I(IM1
| IM2
);
401 O_TYPE
O_bitxor(O_ARGS
)
403 return MPDM_I(IM1
^ IM2
);
408 return MPDM_I(IM1
<< IM2
);
413 return MPDM_I(IM1
>> IM2
);
418 return MPDM_R(pow(RM1
, RM2
));
421 O_TYPE
O_numlt(O_ARGS
)
423 return BOOL(RM1
< RM2
);
426 O_TYPE
O_numle(O_ARGS
)
428 return BOOL(RM1
<= RM2
);
431 O_TYPE
O_numgt(O_ARGS
)
433 return BOOL(RM1
> RM2
);
436 O_TYPE
O_numge(O_ARGS
)
438 return BOOL(RM1
>= RM2
);
441 O_TYPE
O_strcat(O_ARGS
)
443 return mpdm_strcat(M1
, M2
);
446 O_TYPE
O_streq(O_ARGS
)
448 return BOOL(mpdm_cmp(M1
, M2
) == 0);
451 O_TYPE
O_numeq(O_ARGS
)
456 mpdm_t r
= BOOL((v1
== NULL
|| v2
== NULL
) ?
457 (v1
== v2
) : (R(v1
) == R(v2
))
466 O_TYPE
O_break(O_ARGS
)
473 O_TYPE
O_return(O_ARGS
)
482 O_TYPE
execsym(O_ARGS
, int th
)
484 mpdm_t s
, v
, r
= NULL
;
486 /* gets the symbol name */
489 /* gets the symbol value */
492 if (!MPDM_IS_EXEC(v
)) {
493 /* not found or NULL value? error */
497 w
= RF(mpdm_join_s(s
, L
"."));
498 t
= RF(MPDM_2MBS((wchar_t *) w
->data
));
500 snprintf(tmp
, sizeof(tmp
), "Undefined function %s()",
503 mpsl_error(MPDM_MBS(tmp
));
510 r
= th
? mpdm_exec_thread(v
, M2
, l
) : mpdm_exec(v
, M2
, l
);
519 O_TYPE
O_execsym(O_ARGS
)
520 /* executes the value of a symbol */
522 return execsym(c
, a
, l
, f
, 0);
526 O_TYPE
O_threadsym(O_ARGS
)
527 /* executes the value of a symbol in a new thread */
529 return execsym(c
, a
, l
, f
, 1);
533 O_TYPE
O_while(O_ARGS
)
538 for (mpdm_void(M3
); !*f
&& is_true_uf(M1
); mpdm_void(M4
)) {
550 O_TYPE
O_foreach(O_ARGS
)
558 for (n
= 0; n
< mpdm_size(v
) && !*f
; n
++) {
559 SET(s
, mpdm_aget(v
, n
));
574 O_TYPE
O_range(O_ARGS
)
575 /* build list from range of two numeric values */
579 mpdm_t r
= RF(MPDM_A(0));
583 mpdm_push(r
, MPDM_R(v1
));
588 mpdm_push(r
, MPDM_R(v1
));
598 O_TYPE
O_list(O_ARGS
)
599 /* build list from instructions */
601 mpdm_t ret
= RF(mpdm_size(c
) == 2 ? MPDM_A(0) : M(2));
603 mpdm_push(ret
, M(1));
609 O_TYPE
O_ilist(O_ARGS
)
610 /* build and inverse list from instructions */
612 mpdm_t ret
= RF(mpdm_size(c
) == 2 ? MPDM_A(0) : M(2));
614 mpdm_ins(ret
, M(1), 0);
620 O_TYPE
O_hash(O_ARGS
)
621 /* build hash from instructions */
623 mpdm_t ret
= RF(mpdm_size(c
) == 3 ? MPDM_H(0) : M(3));
625 mpdm_hset(ret
, M1
, M2
);
631 O_TYPE
O_blkframe(O_ARGS
)
632 /* runs an instruction under a block frame */
636 /* no context? create one */
642 /* create a new local symbol table */
643 mpdm_push(l
, MPDM_H(0));
645 /* creates the arguments (if any) as local variables */
646 set_local_symbols(M2
, a
, l
);
648 /* execute instruction */
651 /* destroy the local symbol table */
660 O_TYPE
O_subframe(O_ARGS
)
661 /* runs an instruction inside a subroutine frame */
663 /* like a block frame, but with its own symbol table */
664 return O_blkframe(c
, a
, MPDM_A(0), f
);
668 static struct mpsl_op_s
{
671 mpdm_t(*func
) (O_ARGS
);
673 { L
"LITERAL", 0, O_literal
}, /* *must* be the zeroth */
674 { L
"MULTI", 0, O_multi
},
675 { L
"IMULTI", 0, O_imulti
},
676 { L
"SYMVAL", 0, O_symval
},
677 { L
"ASSIGN", 0, O_assign
},
678 { L
"EXECSYM", 0, O_execsym
},
679 { L
"THREADSYM", 0, O_threadsym
},
681 { L
"WHILE", 0, O_while
},
682 { L
"FOREACH", 0, O_foreach
},
683 { L
"SUBFRAME", 0, O_subframe
},
684 { L
"BLKFRAME", 0, O_blkframe
},
685 { L
"BREAK", 0, O_break
},
686 { L
"RETURN", 0, O_return
},
687 { L
"LOCAL", 0, O_local
},
688 { L
"LIST", 1, O_list
},
689 { L
"ILIST", 1, O_ilist
},
690 { L
"HASH", 1, O_hash
},
691 { L
"RANGE", 1, O_range
},
692 { L
"UMINUS", 1, O_uminus
},
693 { L
"ADD", 1, O_add
},
694 { L
"SUB", 1, O_sub
},
695 { L
"MUL", 1, O_mul
},
696 { L
"DIV", 1, O_div
},
697 { L
"MOD", 1, O_mod
},
698 { L
"NOT", 1, O_not
},
699 { L
"AND", 1, O_and
},
701 { L
"NUMEQ", 1, O_numeq
},
702 { L
"NUMLT", 1, O_numlt
},
703 { L
"NUMLE", 1, O_numle
},
704 { L
"NUMGT", 1, O_numgt
},
705 { L
"NUMGE", 1, O_numge
},
706 { L
"STRCAT", 1, O_strcat
},
707 { L
"STREQ", 1, O_streq
},
708 { L
"BITAND", 1, O_bitand
},
709 { L
"BITOR", 1, O_bitor
},
710 { L
"BITXOR", 1, O_bitxor
},
711 { L
"SHL", 1, O_shl
},
712 { L
"SHR", 1, O_shr
},
713 { L
"POW", 1, O_pow
},
718 O_TYPE
mpsl_exec_i(O_ARGS
)
719 /* Executes one MPSL instruction in the MPSL virtual machine. Called
720 from mpsl_exec_p() (which holds the flow control status variable) */
728 /* if aborted or NULL, do nothing */
729 if (!mpsl_abort
&& c
!= NULL
) {
730 /* gets the opcode and calls it */
731 ret
= op_table
[mpdm_ival(C0
)].func(c
, a
, l
, f
);
733 if (mpsl_trap_func
!= NULL
) {
734 mpdm_t f
= mpsl_trap_func
;
738 mpsl_trap_func
= NULL
;
739 mpdm_exec_3(f
, c
, a
, ret
, l
);
754 mpdm_t
mpsl_exec_p(mpdm_t c
, mpdm_t a
, mpdm_t ctxt
)
755 /* executes an MPSL instruction stream */
759 /* execute first instruction with a new flow control variable */
760 return mpsl_exec_i(c
, a
, ctxt
, &f
);
764 static mpdm_t
constant_fold(mpdm_t i
)
765 /* tries to fold complex but constant expressions into a literal */
770 /* get the number opcode */
771 n
= mpdm_ival(mpdm_aget(i
, 0));
773 if (op_table
[n
].foldable
) {
774 /* test if all arguments are literal (opcode 0) */
775 for (n
= 1; n
< mpdm_size(i
); n
++) {
776 mpdm_t t
= mpdm_aget(i
, n
);
778 /* if it's not LITERAL, abort immediately */
779 if (mpdm_ival(mpdm_aget(t
, 0)) != 0)
783 /* execute the instruction and convert to LITERAL */
784 v
= mpsl_exec_p(i
, NULL
, NULL
);
785 i
= mpsl_mkins(L
"LITERAL", 1, v
, NULL
, NULL
, NULL
);
792 mpdm_t
mpsl_mkins(wchar_t * opcode
, int args
, mpdm_t a1
, mpdm_t a2
,
793 mpdm_t a3
, mpdm_t a4
)
794 /* creates an instruction */
799 v
= MPDM_A(args
+ 1);
802 /* inserts the opcode */
803 o
= mpdm_hget_s(mpsl_opcodes
, opcode
);
807 case 4: mpdm_aset(v
, a4
, 4); /* no break */
808 case 3: mpdm_aset(v
, a3
, 3); /* no break */
809 case 2: mpdm_aset(v
, a2
, 2); /* no break */
810 case 1: mpdm_aset(v
, a1
, 1); /* no break */
815 v
= constant_fold(v
);
821 mpdm_t
mpsl_build_opcodes(void)
822 /* builds the table of opcodes */
825 mpdm_t r
= MPDM_H(0);
829 for (n
= 0; op_table
[n
].name
!= NULL
; n
++) {
830 mpdm_t v
= MPDM_LS(op_table
[n
].name
);
834 /* keys and values are the same */
845 * mpsl_trap - Install a trapping function.
846 * @trap_func: The trapping MPSL code
848 * Installs a trapping function. The function is an MPSL
849 * executable value receiving 3 arguments: the code stream,
850 * the arguments and the return value of the executed code.
852 * Returns NULL (previous versions returned the previous
853 * trapping function).
855 mpdm_t
mpsl_trap(mpdm_t trap_func
)
858 mpdm_unref(mpsl_trap_func
);
859 mpsl_trap_func
= trap_func
;
866 * mpsl_argv - Fills the ARGV global array.
867 * @argc: number of arguments
868 * @argv: array of string values
870 * Fills the ARGV global MPSL array with an array of arguments. These
871 * are usually the ones sent to main().
873 void mpsl_argv(int argc
, char *argv
[])
878 /* create the ARGV array */
879 ARGV
= mpdm_hset_s(mpdm_root(), L
"ARGV", MPDM_A(0));
881 for (n
= 0; n
< argc
; n
++)
882 mpdm_push(ARGV
, MPDM_MBS(argv
[n
]));
887 mpdm_t
mpsl_build_funcs(void);
891 * mpsl_startup - Initializes MPSL.
893 * Initializes the Minimum Profit Scripting Language. Returns 0 if
894 * everything went OK.
896 int mpsl_startup(void)
906 /* creates INC, unless already defined */
907 if (mpdm_hget_s(r
, L
"INC") == NULL
)
908 mpdm_hset_s(r
, L
"INC", MPDM_A(0));
911 mpdm_hset_s(r
, L
"TRUE", MPDM_I(1));
913 /* standard file descriptors */
914 mpdm_hset_s(r
, L
"STDIN", MPDM_F(stdin
));
915 mpdm_hset_s(r
, L
"STDOUT", MPDM_F(stdout
));
916 mpdm_hset_s(r
, L
"STDERR", MPDM_F(stderr
));
918 /* home and application directories */
919 mpdm_hset_s(r
, L
"HOMEDIR", mpdm_home_dir());
920 mpdm_hset_s(r
, L
"APPDIR", mpdm_app_dir());
922 /* fill now the MPSL hash */
924 mpdm_hset_s(r
, L
"MPSL", m
);
926 /* store things there */
927 mpdm_hset_s(m
, L
"VERSION", MPDM_MBS(VERSION
));
928 mpdm_hset_s(m
, L
"OPCODE", mpsl_build_opcodes());
929 mpdm_hset_s(m
, L
"LC", MPDM_H(0));
930 mpdm_hset_s(m
, L
"CORE", mpsl_build_funcs());
932 mpdm_dump_1
= mpsl_dump_1
;
939 * mpsl_shutdown - Shuts down MPSL.
941 * Shuts down MPSL. No MPSL functions should be used from now on.
943 void mpsl_shutdown(void)