2 ** Copyright (C) University of Virginia, Massachusetts Institue of Technology 1994-2003.
3 ** See ../LICENSE for license information.
16 ** ctype typ --- type of expression
23 ** } *val --- value, if known. if unknown, val = (_val *)0
25 ** storeRef sref --- storage referred to by expression, of storeRef_null
27 ** cstring etext --- to get nice error messages, punt for now!
30 /* in exprNode_type: typedef struct _exprNode *exprNode; */
34 XPR_PARENS, XPR_ASSIGN, XPR_CALL, XPR_EMPTY, XPR_VAR,
35 XPR_OP, XPR_POSTOP, XPR_PREOP, XPR_SIZEOFT, XPR_SIZEOF, XPR_ALIGNOFT, XPR_ALIGNOF,
36 XPR_OFFSETOF, XPR_CAST, XPR_FETCH, XPR_VAARG, XPR_ITER,
37 XPR_FOR, XPR_FORPRED, XPR_GOTO, XPR_CONTINUE, XPR_BREAK,
38 XPR_RETURN, XPR_NULLRETURN, XPR_COMMA, XPR_COND, XPR_IF, XPR_IFELSE,
39 XPR_DOWHILE, XPR_WHILE, XPR_STMT, XPR_STMTLIST, XPR_SWITCH,
40 XPR_INIT, XPR_FACCESS, XPR_ARROW, XPR_CONST, XPR_STRINGLITERAL,
41 XPR_NUMLIT, XPR_BODY, XPR_NODE, XPR_ITERCALL, XPR_TOK,
42 XPR_WHILEPRED, XPR_CASE, XPR_FTCASE, XPR_DEFAULT, XPR_FTDEFAULT,
43 XPR_BLOCK, XPR_INITBLOCK,
50 /*@only@*/ cstringList field;
55 /*@only@*/ exprNode a;
56 /*@only@*/ exprNode b;
61 /*@only@*/ exprNode pred;
62 /*@only@*/ exprNode tbranch;
63 /*@only@*/ exprNode fbranch;
68 /*@dependent@*/ /*@observer@*/ uentry sname;
69 /*@only@*/ exprNodeList args;
70 /*@only@*/ exprNode body;
71 /*@dependent@*/ /*@observer@*/ uentry ename;
76 /*@only@*/ exprNode fcn;
77 /*@only@*/ exprNodeList args;
82 /*@dependent@*/ /*@exposed@*/ uentry iter;
83 /*@only@*/ exprNodeList args;
88 /*@only@*/ exprNode a;
89 /*@only@*/ exprNode b;
95 /*@only@*/ exprNode rec;
96 /*@only@*/ cstring field;
101 /*@only@*/ exprNode a;
107 /*@only@*/ exprNode exp;
114 /*@only@*/ exprNode exp;
118 typedef /*@null@*/ union
123 qtype qt; /* sizeof(type) */
124 /* use for any 2-operator (comma, arrayFetch, case, stmt) */
126 exprOp op; /* pair + operator */
131 exprIterCall itercall;
135 exprTriple triple; /* ifelse, ternary op, for pred */
139 /*@constant null exprData exprData_undefined; @*/
140 # define exprData_undefined ((exprData) NULL)
144 bool isJumpPoint BOOLBITS; /* expr can be reached non-sequentially */
145 bool canBreak BOOLBITS; /* expr can break (has break, continue) */
146 bool mustBreak BOOLBITS;
152 /*@exposed@*/ sRef sref;
153 sRefSet uses; /* sRef's used by this expression */
154 sRefSet sets; /* sRef's set by this expression */
155 sRefSet msets; /* sRef's possibly set (implicit out params, etc.) */
161 /*@relnull@*/ exprData edata;
163 /*@notnull@*/ constraintList requiresConstraints;
164 /*@notnull@*/ constraintList ensuresConstraints;
167 ** These two are used only for boolean expressions,
168 ** they store the ensures constraints for the true and false cases
171 /*@notnull@*/ constraintList trueEnsuresConstraints;
172 /*@notnull@*/ constraintList falseEnsuresConstraints;
175 /*@constant null exprNode exprNode_undefined; @*/
176 # define exprNode_undefined ((exprNode)NULL)
178 extern /*@falsewhennull@*/ bool exprNode_isDefined (exprNode p_e) /*@*/ ;
179 extern /*@unused@*/ /*@nullwhentrue@*/ bool exprNode_isUndefined (exprNode p_e) /*@*/ ;
180 extern /*@nullwhentrue@*/ bool exprNode_isError (exprNode p_e) /*@*/ ;
182 # define exprNode_isDefined(e) ((e) != exprNode_undefined)
183 # define exprNode_isUndefined(e) ((e) == exprNode_undefined)
184 # define exprNode_isError(e) ((e) == exprNode_undefined)
186 extern /*@dependent@*/ /*@exposed@*/ guardSet
187 exprNode_getGuards (/*@sef@*/ exprNode p_e) /*@*/ ;
188 # define exprNode_getGuards(e) \
189 (exprNode_isDefined(e) ? (e)->guards : guardSet_undefined)
191 extern ctype exprNode_getType (/*@sef@*/ exprNode p_e) /*@*/ ;
192 # define exprNode_getType(e) \
193 (exprNode_isDefined(e) ? (e)->typ : ctype_unknown)
195 extern /*@unused@*/ /*@falsewhennull@*/ bool exprNode_isInParens (/*@sef@*/ exprNode p_e) /*@*/ ;
196 # define exprNode_isInParens(e) \
197 (exprNode_isDefined(e) && (e)->kind == XPR_PARENS)
199 extern bool exprNode_isStringLiteral (/*@sef@*/ exprNode p_e) /*@*/ ;
200 # define exprNode_isStringLiteral(e) \
201 (exprNode_isDefined(e) && (e)->kind == XPR_STRINGLITERAL)
203 extern /*@unused@*/ bool exprNode_knownIntValue (/*@sef@*/ exprNode p_e) /*@*/ ;
204 # define exprNode_knownIntValue(e) \
205 (exprNode_isDefined(e) && multiVal_isInt (exprNode_getValue (e)))
207 extern /*@unused@*/ bool exprNode_knownStringValue (/*@sef@*/ exprNode p_e) /*@*/ ;
208 # define exprNode_knownStringValue(e) \
209 (exprNode_isDefined(e) && multiVal_isString (exprNode_getValue (e)))
211 extern bool exprNode_hasValue (/*@sef@*/ exprNode p_e) /*@*/ ;
212 # define exprNode_hasValue(e) \
213 (exprNode_isDefined(e) && multiVal_isDefined (exprNode_getValue (e)))
215 extern /*@exposed@*/ multiVal exprNode_getValue (exprNode p_e) /*@*/ ;
216 extern long exprNode_getLongValue (exprNode p_e) /*@*/ ;
218 extern /*@observer@*/ cstring exprNode_unparseFirst (exprNode p_e) /*@*/ ;
219 extern /*@observer@*/ guardSet exprNode_getForGuards (exprNode p_pred) /*@*/ ;
220 extern bool exprNode_loopMustExec (exprNode p_forPred) /*@*/ ;
222 extern bool exprNode_isNullValue (exprNode p_e) /*@*/ ;
223 extern /*@exposed@*/ sRef exprNode_getSref (exprNode p_e) /*@*/ ;
224 extern /*@exposed@*/ uentry exprNode_getUentry (exprNode p_e)
225 /*@globals internalState@*/ ;
226 extern void exprNode_produceGuards (exprNode p_pred) /*@modifies p_pred@*/ ;
228 extern /*@observer@*/ fileloc exprNode_loc (exprNode p_e) /*@*/ ;
229 extern /*@observer@*/ fileloc exprNode_getLoc (exprNode p_e) /*@*/ ;
230 # define exprNode_getLoc exprNode_loc
233 exprNode_charLiteral (char p_c, cstring p_text, /*@only@*/ fileloc p_loc) /*@*/ ;
234 extern /*@observer@*/ exprNode exprNode_makeMustExit (void) /*@*/ ;
236 exprNode_cond (/*@keep@*/ exprNode p_pred, /*@keep@*/ exprNode p_ifclause,
237 /*@keep@*/ exprNode p_elseclause) /*@*/ ;
238 extern exprNode exprNode_makeError(void) /*@*/ ;
240 extern exprNode exprNode_makeInitBlock (lltok p_brace, /*@only@*/ exprNodeList p_inits) /*@*/ ;
242 extern exprNode exprNode_functionCall (/*@only@*/ exprNode p_f,
243 /*@only@*/ exprNodeList p_args) /*@*/ ;
244 extern /*@notnull@*/ exprNode
245 exprNode_fromIdentifier (/*@observer@*/ uentry p_c) /*@globals internalState@*/ ;
246 extern exprNode exprNode_fromUIO (cstring p_c) /*@globals internalState@*/ ;
247 extern exprNode exprNode_fieldAccess (/*@only@*/ exprNode p_s,
248 /*@only@*/ lltok p_dot,
249 /*@only@*/ cstring p_f) /*@*/ ;
251 extern exprNode exprNode_arrowAccess (/*@only@*/ exprNode p_s,
252 /*@only@*/ lltok p_arrow,
253 /*@only@*/ cstring p_f) /*@*/ ;
255 extern exprNode exprNode_postOp (/*@only@*/ exprNode p_e, /*@only@*/ lltok p_op)
257 extern exprNode exprNode_preOp (/*@only@*/ exprNode p_e, /*@only@*/ lltok p_op) /*@*/ ;
258 extern exprNode exprNode_addParens (/*@only@*/ lltok p_lpar, /*@only@*/ exprNode p_e) /*@*/ ;
259 extern exprNode exprNode_offsetof (/*@only@*/ qtype p_qt, /*@only@*/ cstringList p_s) /*@*/ ;
260 extern exprNode exprNode_sizeofType (/*@only@*/ qtype p_qt) /*@*/ ;
261 extern exprNode exprNode_sizeofExpr (/*@only@*/ exprNode p_e) /*@*/ ;
262 extern exprNode exprNode_alignofType (/*@only@*/ qtype p_qt) /*@*/ ;
263 extern exprNode exprNode_alignofExpr (/*@only@*/ exprNode p_e) /*@*/ ;
265 exprNode_op (/*@only@*/ exprNode p_e1, /*@keep@*/ exprNode p_e2, /*@only@*/ lltok p_op) /*@*/ ;
267 exprNode_assign (/*@only@*/ exprNode p_e1, /*@only@*/ exprNode p_e2, /*@only@*/ lltok p_op) ;
269 exprNode_arrayFetch (/*@only@*/ exprNode p_e1, /*@only@*/ exprNode p_e2)
270 /*@modifies p_e1, p_e2@*/ ;
272 extern void exprNode_free (/*@only@*/ exprNode p_e) ;
274 exprNode_vaArg (/*@only@*/ lltok p_tok, /*@only@*/ exprNode p_arg, /*@only@*/ qtype p_qt)
275 /*@globals internalState@*/ ;
277 extern bool exprNode_isMultiStatement (exprNode p_e) /*@*/ ;
280 ** Has surrounding quotes.
283 extern /*@only@*/ /*@notnull@*/ exprNode
284 exprNode_stringLiteral (/*@only@*/ cstring p_t, /*@only@*/ fileloc p_loc) /*@*/ ;
286 extern /*@only@*/ /*@notnull@*/ exprNode
287 exprNode_wideStringLiteral (/*@only@*/ cstring p_t, /*@only@*/ fileloc p_loc) /*@*/ ;
290 ** No surrounding quotes.
293 extern /*@notnull@*/ exprNode
294 exprNode_rawStringLiteral (/*@only@*/ cstring p_t, /*@only@*/ fileloc p_loc) /*@*/ ;
296 extern exprNode exprNode_comma (/*@only@*/ exprNode p_e1, /*@only@*/ exprNode p_e2) /*@*/ ;
297 extern exprNode exprNode_labelMarker (/*@only@*/ cstring p_label);
299 exprNode_notReached (/*@returned@*/ exprNode p_stmt);
302 exprNode exprNode_caseMarker (/*@only@*/ exprNode p_test, bool p_fallThrough) /*@*/ ;
304 extern exprNode exprNode_concat (/*@only@*/ exprNode p_e1, /*@only@*/ exprNode p_e2);
305 extern /*@notnull@*/ exprNode exprNode_createTok (/*@only@*/ lltok p_t) /*@*/ ;
306 extern exprNode exprNode_statement (/*@only@*/ exprNode p_e, /*@only@*/ lltok p_t);
307 extern exprNode exprNode_makeBlock (/*@only@*/ exprNode p_e);
308 extern exprNode exprNode_compoundStatementExpression (/*@only@*/ lltok p_tlparen, /*@only@*/ exprNode p_e) ;
310 extern void exprNode_checkIfPred (exprNode p_pred) /*@modifies g_warningstream@*/ ;
312 extern exprNode exprNode_if (/*@only@*/ exprNode p_pred, /*@only@*/ exprNode p_tclause);
314 exprNode_ifelse (/*@only@*/ exprNode p_pred, /*@only@*/ exprNode p_tclause,
315 /*@only@*/ exprNode p_eclause);
316 extern exprNode exprNode_switch (/*@only@*/ exprNode p_e, /*@only@*/ exprNode p_s);
317 extern exprNode exprNode_while (/*@keep@*/ exprNode p_t, /*@keep@*/ exprNode p_b);
318 extern exprNode exprNode_doWhile (/*@only@*/ exprNode p_b, /*@only@*/ exprNode p_t);
319 extern /*@notnull@*/ /*@only@*/ exprNode exprNode_goto (/*@only@*/ cstring p_label);
320 extern exprNode exprNode_continue (/*@only@*/ lltok p_l, int p_qcontinue);
321 extern exprNode exprNode_break (/*@only@*/ lltok p_l, int p_bqual);
322 extern exprNode exprNode_nullReturn (/*@only@*/ lltok p_t);
323 extern exprNode exprNode_return (/*@only@*/ exprNode p_e);
324 extern /*@dependent@*/ /*@observer@*/ cstring
325 exprNode_unparse (/*@temp@*/ exprNode p_e) /*@*/ ;
327 extern /*@falsewhennull@*/ bool exprNode_isBlock (exprNode p_e) /*@*/ ;
328 extern /*@falsewhennull@*/ bool exprNode_isCharLiteral (exprNode p_e) /*@*/ ;
329 extern /*@falsewhennull@*/ bool exprNode_isNumLiteral (exprNode p_e) /*@*/ ;
332 exprNode_makeInitialization (/*@only@*/ idDecl p_t, /*@only@*/ exprNode p_e);
334 exprNode exprNode_makeEmptyInitialization (/*@only@*/ idDecl p_t) ;
336 extern bool exprNode_isInitializer (exprNode p_e) /*@*/ ;
338 extern bool exprNode_matchType (ctype p_expected, exprNode p_e);
340 extern /*@notnull@*/ /*@only@*/ exprNode
341 exprNode_defaultMarker (/*@only@*/ lltok p_def, bool p_fallThrough);
344 exprNode_iter (/*@observer@*/ uentry p_name, /*@only@*/ exprNodeList p_alist,
345 /*@only@*/ exprNode p_body, /*@observer@*/ uentry p_end);
346 extern exprNode exprNode_iterId (/*@observer@*/ uentry p_c);
347 extern exprNode exprNode_iterExpr (/*@returned@*/ exprNode p_e);
348 extern exprNode exprNode_iterNewId (/*@only@*/ cstring p_s);
350 exprNode_iterStart (/*@observer@*/ uentry p_name, /*@only@*/ exprNodeList p_alist);
351 extern exprNode exprNode_numLiteral (ctype p_c, /*@temp@*/ cstring p_t,
352 /*@only@*/ fileloc p_loc, long p_val) /*@*/ ;
353 extern void exprNode_initMod (void) /*@modifies internalState@*/ ;
354 extern exprNode exprNode_for (/*@keep@*/ exprNode p_inc, /*@keep@*/ exprNode p_body);
356 exprNode_forPred (/*@only@*/ exprNode p_init,
357 /*@only@*/ exprNode p_test, /*@only@*/ exprNode p_inc);
358 extern exprNode exprNode_floatLiteral (double p_d, ctype p_ct,
359 cstring p_text, /*@only@*/ fileloc p_loc) /*@*/ ;
360 extern /*@notnull@*/ exprNode exprNode_createId (/*@observer@*/ uentry p_c);
361 extern /*@notnull@*/ exprNode exprNode_makeConstantString (/*@temp@*/ cstring p_c, /*@only@*/ fileloc p_loc) /*@*/ ;
362 extern exprNode exprNode_cast (/*@only@*/ lltok p_tok, /*@only@*/ exprNode p_e, /*@only@*/ qtype p_q);
363 extern bool exprNode_matchLiteral (ctype p_expected, exprNode p_e);
364 extern void exprNode_checkUseParam (exprNode p_current);
365 extern void exprNode_checkSet (exprNode p_e, /*@exposed@*/ sRef p_s);
366 extern void exprNode_checkMSet (exprNode p_e, /*@exposed@*/ sRef p_s);
367 extern exprNode exprNode_checkExpr (/*@returned@*/ exprNode p_e);
368 extern bool exprNode_mustEscape (exprNode p_e);
369 extern bool exprNode_errorEscape (exprNode p_e);
370 extern bool exprNode_mayEscape (exprNode p_e);
371 extern exprNode exprNode_whilePred (/*@only@*/ exprNode p_test);
373 exprNode_updateLocation (/*@returned@*/ exprNode p_e, /*@temp@*/ fileloc p_loc);
374 extern void exprNode_freeShallow (/*@only@*/ exprNode p_e);
375 extern void exprNode_destroyMod (void) /*@modifies internalState@*/ ;
376 extern /*@falsewhennull@*/ bool exprNode_isAssign (exprNode p_e) /*@*/ ;
379 extern bool exprNode_isDefaultMarker (exprNode p_e) /*@*/ ;
380 extern bool exprNode_isCaseMarker (exprNode p_e) /*@*/ ;
381 extern bool exprNode_isLabelMarker (exprNode p_e) /*@*/ ;
384 extern /*@only@*/ exprNode exprNode_combineLiterals (/*@only@*/ exprNode p_e, /*@only@*/ exprNode p_rest) ;
386 extern /*@only@*/ fileloc exprNode_getNextSequencePoint (exprNode p_e) ;
389 exprNode exprNode_createNew(ctype p_c);
392 bool exprNode_isInitBlock (exprNode p_e);
395 # error "Multiple include"