XEphem/GUI/xephem/compiler.c

590 lines
16 KiB
C

/* module to compile and execute a c-style arithmetic expression.
* public entry points are compile_expr() and execute_expr().
*
* field names are defined to be anything in double quotes when compiling.
* the compiler will build a table of names it sees; indexes into this table
* are part of the opcode. Field names are resolved when the expression is
* evaluated to avoid restricting when the fields are named and defined.
*
* one reason this is so nice and tight is that all opcodes are the same size
* (an int) and the tokens the parser returns are directly usable as opcodes.
* constants and variables are compiled as an opcode with an offset into the
* auxiliary consts and vars arrays.
*/
#include <stdio.h>
#include <math.h>
#include <ctype.h>
#include <stdlib.h>
#include <X11/Xlib.h>
#include <Xm/Xm.h>
#include "xephem.h"
static int next_token (void);
static int chk_funcs (void);
static void skip_double (void);
static int compile (int prec);
static int execute (double *result);
static int parse_fieldname (char name[], int len);
/* parser tokens and opcodes, as necessary */
#define HALT 0 /* good value for HALT since program is inited to 0 */
/* binary operators (precedences in table, below) */
#define ADD 1
#define SUB 2
#define MULT 3
#define DIV 4
#define AND 5
#define OR 6
#define GT 7
#define GE 8
#define EQ 9
#define NE 10
#define LT 11
#define LE 12
/* unary op, precedence in NEG_PREC #define, below */
#define NEG 13
/* symantically operands, ie, constants, variables and all functions */
#define CONST 14
#define VAR 15
#define ABS 16 /* add functions if desired just like this is done */
#define FLOOR 17
#define SIN 18
#define COS 19
#define TAN 20
#define ASIN 21
#define ACOS 22
#define ATAN 23
#define PITOK 24 /* built-in constant, pi */
#define DEGRAD 25
#define RADDEG 26
#define LOG 27
#define LOG10 28
#define EXP 29
#define SQRT 30
#define POW 31
#define ATAN2 32
/* purely tokens - never get compiled as such */
#define LPAREN 255
#define RPAREN 254
#define COMMA 253
#define ERR (-1)
/* precedence of each of the binary operators.
* in case of a tie, compiler associates left-to-right.
* N.B. each entry's index must correspond to its #define!
*/
static int precedence[] = {0,5,5,6,6,2,1,4,4,3,3,4,4};
#define NEG_PREC 7 /* negation is highest */
/* execute-time operand stack */
#define MAX_STACK 16
static double stack[MAX_STACK], *sp;
/* space for compiled opcodes - the "program".
* opcodes go in lower 8 bits.
* when an opcode has an operand (as CONST and VAR) it is really an array
* index in the remaining upper bits.
*/
#define MAX_PROG 32
static int program[MAX_PROG], *pc;
#define OP_SHIFT 8
#define OP_MASK 0xff
/* auxiliary operand info.
* the operands (all but lower 8 bits) of CONST and VAR are really indeces
* into these arrays. thus, no point in making them any longer than you have
* bits more than 8 in your machine's int to index into it, ie, make
* MAX_OPX <= 1 << ((sizeof(int)-1)*8)
*/
#define MAX_OPX 16
#define MAXFLDLEN 32 /* longest allowed field name */
typedef struct {
char v_name[MAXFLDLEN]; /* name of field */
double v_v; /* last known value of this field */
} Var;
static Var vars[MAX_OPX];
static int nvars; /* number of vars[] in actual use */
static double consts[MAX_OPX];
static int nconsts; /* number of consts[] in actual use */
/* these are global just for easy/rapid access */
static int parens_nest; /* to check that parens end up nested */
static char *err_msg; /* caller provides storage; we point at it with this */
static char *cexpr, *lcexpr; /* pointers that move along caller's expression */
static int good_prog; /* != 0 when program appears to be good */
/* compile the given c-style expression.
* return 0 and set good_prog if ok,
* else return -1 and a reason message in errbuf.
*/
int
compile_expr (ex, errbuf)
char *ex;
char *errbuf;
{
/* init the globals.
* also delete any flogs used in the previous program.
*/
cexpr = ex;
err_msg = errbuf;
pc = program;
nvars = nconsts = 0;
parens_nest = 0;
pc = program;
if (compile(0) == ERR) {
(void) sprintf (err_msg + strlen(err_msg), " near `%.10s'", lcexpr);
good_prog = 0;
return (-1);
}
if (pc == program) {
(void) sprintf (err_msg, "Null program");
good_prog = 0;
return (-1);
}
*pc++ = HALT;
good_prog = 1;
return (0);
}
/* execute the expression previously compiled with compile_expr().
* return 0 with *vp set to the answer if ok, else return -1 with a reason
* why not message in errbuf.
*/
int
execute_expr (vp, errbuf)
double *vp;
char *errbuf;
{
int s;
err_msg = errbuf;
sp = stack + MAX_STACK; /* grows towards lower addresses */
pc = program;
s = execute(vp);
if (s < 0)
good_prog = 0;
return (s);
}
/* this is a way for the outside world to ask whether there is currently a
* reasonable program compiled and able to execute.
*/
int
prog_isgood (void)
{
return (good_prog);
}
/* called when each different field is written.
* this is just called by srch_log() to hide the fact from users of srch*
* that srch is really using our vars array to store values.
* since this gets called for all fields, it's not an error to not find name.
* don't stop when see the first one because a term might appear more than once.
*/
void
compiler_log (name, value)
char *name;
double value;
{
Var *vp;
for (vp = vars; vp < &vars[nvars]; vp++)
if (vp->v_name && strcmp (vp->v_name, name) == 0)
vp->v_v = value;
}
/* get and return the opcode corresponding to the next token.
* leave with lcexpr pointing at the new token, cexpr just after it.
* also watch for mismatches parens and proper operator/operand alternation.
*/
static int
next_token (void)
{
static char toomv[] = "More than %d variables";
static char toomc[] = "More than %d constants";
static char badop[] = "Illegal operator";
int tok = ERR; /* just something illegal */
char c;
while (isspace(c = *cexpr))
cexpr++;
lcexpr = cexpr++;
/* mainly check for a binary operator */
switch (c) {
case ',': tok = COMMA; break;
case '\0': --cexpr; tok = HALT; break; /* keep returning HALT */
case '+': tok = ADD; break; /* compiler knows when it's really unary */
case '-': tok = SUB; break; /* compiler knows when it's really negate */
case '*': tok = MULT; break;
case '/': tok = DIV; break;
case '(': parens_nest++; tok = LPAREN; break;
case ')':
if (--parens_nest < 0) {
(void) sprintf (err_msg, "Too many right parens");
return (ERR);
} else
tok = RPAREN;
break;
case '|':
if (*cexpr == '|') { cexpr++; tok = OR; }
else { (void) strcpy (err_msg, badop); return (ERR); }
break;
case '&':
if (*cexpr == '&') { cexpr++; tok = AND; }
else { (void) strcpy (err_msg, badop); return (ERR); }
break;
case '=':
if (*cexpr == '=') { cexpr++; tok = EQ; }
else { (void) strcpy (err_msg, badop); return (ERR); }
break;
case '!':
if (*cexpr == '=') { cexpr++; tok = NE; }
else { (void) strcpy (err_msg, badop); return (ERR); }
break;
case '<':
if (*cexpr == '=') { cexpr++; tok = LE; }
else tok = LT;
break;
case '>':
if (*cexpr == '=') { cexpr++; tok = GE; }
else tok = GT;
break;
}
if (tok != ERR)
return (tok);
/* not op so check for a constant, variable or function */
if (isdigit(c) || c == '.') {
/* looks like a constant.
* leading +- already handled
*/
if (nconsts > MAX_OPX) {
(void) sprintf (err_msg, toomc, MAX_OPX);
return (ERR);
}
consts[nconsts] = atod (lcexpr);
tok = CONST | (nconsts++ << OP_SHIFT);
skip_double();
} else if (isalpha(c)) {
/* check list of functions */
tok = chk_funcs();
if (tok == ERR) {
(void) sprintf (err_msg, "Bad function");
return (ERR);
}
} else if (c == '"') {
/* a variable */
if (nvars > MAX_OPX) {
(void) sprintf (err_msg, toomv, MAX_OPX);
return (ERR);
}
if (parse_fieldname (vars[nvars].v_name, MAXFLDLEN) < 0) {
(void) sprintf (err_msg, "Bad field");
return (ERR);
} else
tok = VAR | (nvars++ << OP_SHIFT);
}
if (tok != ERR)
return (tok);
/* what the heck is it? */
(void) sprintf (err_msg, "Syntax error");
return (ERR);
}
/* return funtion token, else ERR.
* if find one, update cexpr too.
*/
static int
chk_funcs (void)
{
static struct {
char *st_name;
int st_tok;
} symtab[] = {
/* be sure to put short names AFTER longer ones.
* otherwise, order does not matter.
*/
{"abs", ABS}, {"floor", FLOOR}, {"acos", ACOS},
{"asin", ASIN}, {"atan2", ATAN2}, {"atan", ATAN},
{"cos", COS}, {"degrad", DEGRAD}, {"exp", EXP},
{"log10", LOG10}, {"log", LOG}, {"pi", PITOK},
{"pow", POW}, {"raddeg", RADDEG}, {"sin", SIN},
{"sqrt", SQRT}, {"tan", TAN},
};
int i;
for (i = 0; i < sizeof(symtab)/sizeof(symtab[0]); i++) {
int l = strlen (symtab[i].st_name);
if (strncmp (lcexpr, symtab[i].st_name, l) == 0) {
cexpr += l-1;
return (symtab[i].st_tok);
}
}
return (ERR);
}
/* move cexpr on past a double.
* allow sci notation.
* no need to worry about a leading '-' or '+' but allow them after an 'e'.
* TODO: this handles all the desired cases, but also admits a bit too much
* such as things like 1eee2...3. geeze; to skip a double right you almost
* have to go ahead and crack it!
*/
static void
skip_double (void)
{
int sawe = 0; /* so we can allow '-' or '+' right after an 'e' */
for (;;) {
char c = *cexpr;
if (isdigit(c) || c=='.' || (sawe && (c=='-' || c=='+'))) {
sawe = 0;
cexpr++;
} else if (c == 'e') {
sawe = 1;
cexpr++;
} else
break;
}
}
/* call this whenever you want to dig out the next (sub)expression.
* keep compiling instructions as long as the operators are higher precedence
* than prec (or until see HALT, COMMA or RPAREN) then return that
* "look-ahead" token.
* if error, fill in a message in err_msg[] and return ERR.
*/
static int
compile (prec)
int prec;
{
int expect_binop = 0; /* set after we have seen any operand.
* used by SUB so it can tell if it really
* should be taken to be a NEG instead.
*/
int tok = next_token ();
int *oldpc;
for (;;) {
int p;
if (tok == ERR)
return (ERR);
if (pc - program >= MAX_PROG) {
(void) sprintf (err_msg, "Program is too long");
return (ERR);
}
/* check for special things like functions, constants and parens */
switch (tok & OP_MASK) {
case COMMA: return (tok);
case HALT: return (tok);
case ADD:
if (expect_binop)
break; /* procede with binary addition */
/* just skip a unary positive(?) */
tok = next_token();
if (tok == HALT) {
(void) sprintf (err_msg, "Term expected");
return (ERR);
}
continue;
case SUB:
if (expect_binop)
break; /* procede with binary subtract */
oldpc = pc;
tok = compile (NEG_PREC);
if (oldpc == pc) {
(void) sprintf (err_msg, "Term expected");
return (ERR);
}
*pc++ = NEG;
expect_binop = 1;
continue;
/* one-arg functions */
case ABS: case FLOOR: case SIN: case COS: case TAN: case ASIN:
case ACOS: case ATAN: case DEGRAD: case RADDEG: case LOG:
case LOG10: case EXP: case SQRT:
/* eat up the function's parenthesized argument */
if (next_token() != LPAREN) {
(void) sprintf (err_msg, "Saw a built-in function: expecting (");
return (ERR);
}
oldpc = pc;
if (compile (0) != RPAREN || oldpc == pc) {
(void) sprintf (err_msg, "1-arg function arglist error");
return (ERR);
}
*pc++ = tok;
tok = next_token();
expect_binop = 1;
continue;
/* two-arg functions */
case POW: case ATAN2:
/* eat up the function's parenthesized arguments */
if (next_token() != LPAREN) {
(void) sprintf (err_msg, "Saw a built-in function: expecting (");
return (ERR);
}
oldpc = pc;
if (compile (0) != COMMA || oldpc == pc) {
(void) sprintf (err_msg, "1st of 2-arg function arglist error");
return (ERR);
}
oldpc = pc;
if (compile (0) != RPAREN || oldpc == pc) {
(void) sprintf (err_msg, "2nd of 2-arg function arglist error");
return (ERR);
}
*pc++ = tok;
tok = next_token();
expect_binop = 1;
continue;
/* constants and variables are just like 0-arg functions w/o ()'s */
case CONST:
case PITOK:
case VAR:
*pc++ = tok;
tok = next_token();
expect_binop = 1;
continue;
case LPAREN:
oldpc = pc;
if (compile (0) != RPAREN) {
(void) sprintf (err_msg, "Unmatched left paren");
return (ERR);
}
if (oldpc == pc) {
(void) sprintf (err_msg, "Null expression");
return (ERR);
}
tok = next_token();
expect_binop = 1;
continue;
case RPAREN:
return (RPAREN);
}
/* everything else is a binary operator */
p = precedence[tok];
if (p > prec) {
int newtok;
oldpc = pc;
newtok = compile (p);
if (newtok == ERR)
return (ERR);
if (oldpc == pc) {
(void) strcpy (err_msg, "Term or factor expected");
return (ERR);
}
*pc++ = tok;
expect_binop = 1;
tok = newtok;
} else
return (tok);
}
}
/* "run" the program[] compiled with compile().
* if ok, return 0 and the final result,
* else return -1 with a reason why not message in err_msg.
*/
static int
execute(result)
double *result;
{
int instr;
do {
instr = *pc++;
switch (instr & OP_MASK) {
/* put these in numberic order so hopefully even the dumbest
* compiler will choose to use a jump table, not a cascade of ifs.
*/
case HALT: break; /* outer loop will stop us */
case ADD: sp[1] = sp[1] + sp[0]; sp++; break;
case SUB: sp[1] = sp[1] - sp[0]; sp++; break;
case MULT: sp[1] = sp[1] * sp[0]; sp++; break;
case DIV: sp[1] = sp[1] / sp[0]; sp++; break;
case AND: sp[1] = sp[1] && sp[0] ? 1 : 0; sp++; break;
case OR: sp[1] = sp[1] || sp[0] ? 1 : 0; sp++; break;
case GT: sp[1] = sp[1] > sp[0] ? 1 : 0; sp++; break;
case GE: sp[1] = sp[1] >= sp[0] ? 1 : 0; sp++; break;
case EQ: sp[1] = sp[1] == sp[0] ? 1 : 0; sp++; break;
case NE: sp[1] = sp[1] != sp[0] ? 1 : 0; sp++; break;
case LT: sp[1] = sp[1] < sp[0] ? 1 : 0; sp++; break;
case LE: sp[1] = sp[1] <= sp[0] ? 1 : 0; sp++; break;
case NEG: *sp = -*sp; break;
case CONST: *--sp = consts[instr >> OP_SHIFT]; break;
case VAR: *--sp = vars[instr>>OP_SHIFT].v_v; break;
case PITOK: *--sp = 4.0*atan(1.0); break;
case ABS: *sp = fabs (*sp); break;
case FLOOR: *sp = floor (*sp); break;
case SIN: *sp = sin (*sp); break;
case COS: *sp = cos (*sp); break;
case TAN: *sp = tan (*sp); break;
case ASIN: *sp = asin (*sp); break;
case ACOS: *sp = acos (*sp); break;
case ATAN: *sp = atan (*sp); break;
case DEGRAD:*sp *= atan(1.0)/45.0; break;
case RADDEG:*sp *= 45.0/atan(1.0); break;
case LOG: *sp = log (*sp); break;
case LOG10: *sp = log10 (*sp); break;
case EXP: *sp = exp (*sp); break;
case SQRT: *sp = sqrt (*sp); break;
case POW: sp[1] = pow (sp[1], sp[0]); sp++; break;
case ATAN2: sp[1] = atan2 (sp[1], sp[0]); sp++; break;
default:
(void) sprintf (err_msg, "Bug! bad opcode: 0x%x", instr);
return (-1);
}
if (sp < stack) {
(void) sprintf (err_msg, "Runtime stack overflow");
return (-1);
} else if (sp - stack > MAX_STACK) {
(void) sprintf (err_msg, "Bug! runtime stack underflow");
return (-1);
}
} while (instr != HALT);
/* result should now be on top of stack */
if (sp != &stack[MAX_STACK - 1]) {
(void) sprintf (err_msg, "Bug! stack has %d items",
(int)(MAX_STACK - (sp-stack)));
return (-1);
}
*result = *sp;
return (0);
}
/* starting with lcexpr pointing at a string expected to be a field name,
* ie, at a '"', fill into up to the next '"' into name[], including trailing 0.
* if there IS no '"' within len-1 chars, return -1, else 0.
* when return, leave lcexpr alone but move cexpr to just after the second '"'.
*/
static int
parse_fieldname (name, len)
char name[];
int len;
{
char c = '\0';
cexpr = lcexpr + 1;
while (--len > 0 && (c = *cexpr++) != '"' && c)
*name++ = c;
if (len == 0 || c != '"')
return (-1);
*name = '\0';
return (0);
}