Qore Programming Language  0.8.7
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
QoreProgram.h
1 /* -*- mode: c++; indent-tabs-mode: nil -*- */
2 /*
3  QoreProgram.h
4 
5  Program Object Definition
6 
7  Qore Programming Language
8 
9  Copyright 2003 - 2013 David Nichols
10 
11  This library is free software; you can redistribute it and/or
12  modify it under the terms of the GNU Lesser General Public
13  License as published by the Free Software Foundation; either
14  version 2.1 of the License, or (at your option) any later version.
15 
16  This library is distributed in the hope that it will be useful,
17  but WITHOUT ANY WARRANTY; without even the implied warranty of
18  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19  Lesser General Public License for more details.
20 
21  You should have received a copy of the GNU Lesser General Public
22  License along with this library; if not, write to the Free Software
23  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24 */
25 
26 #ifndef _QORE_QOREPROGRAM_H
27 
28 #define _QORE_QOREPROGRAM_H
29 
30 #include <qore/AbstractPrivateData.h>
31 #include <qore/Restrictions.h>
32 
33 // warnings - must correspond with the string order in QoreProgram.cpp
34 // new warnings must also be added as constants
35 #define QP_WARN_NONE 0
36 #define QP_WARN_WARNING_MASK_UNCHANGED (1 << 0)
37 #define QP_WARN_DUPLICATE_LOCAL_VARS (1 << 1)
38 #define QP_WARN_UNKNOWN_WARNING (1 << 2)
39 #define QP_WARN_UNDECLARED_VAR (1 << 3)
40 #define QP_WARN_DUPLICATE_GLOBAL_VARS (1 << 4)
41 #define QP_WARN_UNREACHABLE_CODE (1 << 5)
42 #define QP_WARN_NONEXISTENT_METHOD_CALL (1 << 6)
43 #define QP_WARN_INVALID_OPERATION (1 << 7)
44 #define QP_WARN_CALL_WITH_TYPE_ERRORS (1 << 8)
45 #define QP_WARN_RETURN_VALUE_IGNORED (1 << 9)
46 #define QP_WARN_DEPRECATED (1 << 10)
47 #define QP_WARN_EXCESS_ARGS (1 << 11)
48 #define QP_WARN_DUPLICATE_HASH_KEY (1 << 12)
49 #define QP_WARN_UNREFERENCED_VARIABLE (1 << 13)
50 #define QP_WARN_DUPLICATE_BLOCK_VARS (1 << 14)
51 #define QP_WARN_MODULE_ONLY (1 << 15)
52 #define QP_WARN_ALL -1
53 
54 #define QP_WARN_MODULES (QP_WARN_UNREACHABLE_CODE|QP_WARN_NONEXISTENT_METHOD_CALL|QP_WARN_INVALID_OPERATION|QP_WARN_CALL_WITH_TYPE_ERRORS|QP_WARN_RETURN_VALUE_IGNORED|QP_WARN_DUPLICATE_HASH_KEY|QP_WARN_DUPLICATE_BLOCK_VARS)
55 
56 #define QP_WARN_DEFAULT (QP_WARN_UNKNOWN_WARNING|QP_WARN_MODULES|QP_WARN_DEPRECATED)
57 
59 DLLEXPORT extern const char** qore_warnings;
60 
62 DLLEXPORT extern unsigned qore_num_warnings;
63 
65 DLLEXPORT int get_warning_code(const char* str);
66 
68 class LocalVar;
69 class ExceptionSink;
70 class QoreListNode;
71 class QoreNamespace;
72 class RootQoreNamespace;
73 class QoreStringNode;
74 class QoreHashNode;
75 class FunctionCallNode;
76 class AbstractStatement;
77 class UnresolvedProgramCallReferenceNode;
78 class Var;
79 class LVList;
80 class UserFunctionVariant;
81 class QoreTypeInfo;
82 class QoreParseTypeInfo;
83 class ParamList;
84 class AbstractQoreZoneInfo;
85 class qore_program_private;
86 
88 
96  friend class qore_program_private_base;
97  friend class qore_program_private;
98 private:
100  qore_program_private* priv;
101 
103  DLLLOCAL QoreProgram(const QoreProgram&);
104 
106  DLLLOCAL QoreProgram& operator=(const QoreProgram&);
107 
108 protected:
110 
112  DLLLOCAL virtual ~QoreProgram();
113 
114 public:
116  DLLEXPORT QoreProgram();
117 
119 
122  DLLEXPORT QoreProgram(int64 parse_options);
123 
125 
130  DLLEXPORT AbstractQoreNode* callFunction(const char* name, const QoreListNode* args, ExceptionSink* xsink);
131 
133 
141  DLLEXPORT AbstractQoreNode* run(ExceptionSink* xsink);
142 
144 
151  DLLEXPORT AbstractQoreNode* runTopLevel(ExceptionSink* xsink);
152 
154 
164  DLLEXPORT void parseFileAndRun(const char* filename);
165 
167 
176  DLLEXPORT void parseAndRun(FILE *fp, const char* name);
177 
179 
188  DLLEXPORT void parseAndRun(const char* str, const char* name);
189 
191 
198  DLLEXPORT void runClass(const char* classname, ExceptionSink* xsink);
199 
201 
212  DLLEXPORT void parseFileAndRunClass(const char* filename, const char* classname);
213 
215 
225  DLLEXPORT void parseAndRunClass(FILE *fp, const char* name, const char* classname);
226 
228 
238  DLLEXPORT void parseAndRunClass(const char* str, const char* name, const char* classname);
239 
241 
249  DLLEXPORT void parse(FILE *fp, const char* name, ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL);
250 
252 
260  DLLEXPORT void parse(const QoreString* str, const QoreString* lstr, ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL);
261 
263 
273  DLLEXPORT void parse(const QoreString* str, const QoreString* lstr, ExceptionSink* xsink, ExceptionSink* warn_sink, int warn_mask, const QoreString* source, int offset);
274 
276 
284  DLLEXPORT void parse(const char* str, const char* lstr, ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL);
285 
287 
297  DLLEXPORT void parse(const char* str, const char* lstr, ExceptionSink* xsink, ExceptionSink* warn_sink, int warn_mask, const char* source, int offset);
298 
300 
308  DLLEXPORT void parseFile(const char* filename, ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL, bool only_first_except = false);
309 
311 
320  DLLEXPORT void parsePending(const char* code, const char* label, ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL);
321 
323 
335  DLLEXPORT void parsePending(const char* code, const char* label, ExceptionSink* xsink, ExceptionSink* warn_sink, int warn_mask, const char* source, int offset);
336 
338 
348  DLLEXPORT void parsePending(const QoreString* str, const QoreString* lstr, ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL);
349 
351 
363  DLLEXPORT void parsePending(const QoreString* str, const QoreString* lstr, ExceptionSink* xsink, ExceptionSink* warn_sink, int warn_mask, const QoreString* source, int offset);
364 
366 
370  DLLEXPORT void parseCommit(ExceptionSink* xsink, ExceptionSink* warn_sink = 0, int warn_mask = QP_WARN_ALL);
371 
373 
377  DLLEXPORT void parseRollback();
378 
380  DLLEXPORT bool existsFunction(const char* name);
381 
383 
388  DLLEXPORT virtual void deref(ExceptionSink* xsink);
389 
391  DLLEXPORT void lockOptions();
392 
394 
399  DLLEXPORT void setExecClass(const char* ecn = 0);
400 
402  DLLEXPORT void parseSetParseOptions(int po);
403 
405  DLLEXPORT void parseSetParseOptions(int64 po);
406 
408  DLLEXPORT void parseDisableParseOptions(int64 po);
409 
411  DLLEXPORT void waitForTermination();
412 
414 
417  DLLEXPORT void waitForTerminationAndDeref(ExceptionSink* xsink);
418 
420  DLLEXPORT QoreNamespace* getQoreNS() const;
421 
423  DLLEXPORT RootQoreNamespace* getRootNS() const;
424 
426 
430  DLLEXPORT int setWarningMask(int wm);
431 
433 
437  DLLEXPORT int enableWarning(int code);
438 
440 
444  DLLEXPORT int disableWarning(int code);
445 
447  DLLEXPORT int getParseOptions() const;
448 
450  DLLEXPORT int64 getParseOptions64() const;
451 
453 
457  DLLEXPORT void setParseOptions(int po, ExceptionSink* xsink);
458 
460 
464  DLLEXPORT void setParseOptions(int64 po, ExceptionSink* xsink);
465 
467 
471  DLLEXPORT void disableParseOptions(int po, ExceptionSink* xsink);
472 
474 
478  DLLEXPORT void disableParseOptions(int64 po, ExceptionSink* xsink);
479 
481 
485  DLLEXPORT void replaceParseOptions(int64 po, ExceptionSink* xsink);
486 
488 
491  DLLEXPORT QoreListNode* getUserFunctionList();
492 
494  DLLEXPORT bool checkWarning(int code) const;
495 
497  DLLEXPORT int getWarningMask() const;
498 
500  DLLEXPORT bool checkFeature(const char* f) const;
501 
503  DLLEXPORT QoreListNode* getFeatureList() const;
504 
506 
508  DLLEXPORT QoreStringNode* getScriptName() const;
509 
511 
513  DLLEXPORT QoreStringNode* getScriptPath() const;
514 
516 
518  DLLEXPORT QoreStringNode* getScriptDir() const;
519 
521 
523  DLLEXPORT void setScriptPath(const char* path);
524 
526 
530  DLLEXPORT AbstractQoreNode* getGlobalVariableValue(const char* var, bool &found) const;
531 
532  // retrieves the time zone setting for the program
533  DLLEXPORT const AbstractQoreZoneInfo *currentTZ() const;
534 
535  // sets the program's time zone
536  DLLEXPORT void setTZ(const AbstractQoreZoneInfo *n_TZ);
537 
539 
542  DLLEXPORT void addFeature(const char* name);
543 
545 
547  DLLEXPORT void parseSetTimeZone(const char* zone);
548 
550 
557  DLLEXPORT void parseDefine(const char* str, AbstractQoreNode* val);
558 
560 
567  DLLEXPORT void parseDefine(const char* str, const char* val);
568 
569  DLLLOCAL QoreProgram(QoreProgram* pgm, int64 po, bool ec = false, const char* ecn = 0);
570 
571  DLLLOCAL LocalVar *createLocalVar(const char* name, const QoreTypeInfo *typeInfo);
572 
573  // returns 0 if a "requires" exception has already occurred
574  DLLLOCAL ExceptionSink* getParseExceptionSink();
575 
576  DLLLOCAL QoreHashNode* getThreadData();
577  DLLLOCAL void depRef();
578  DLLLOCAL void depDeref(ExceptionSink* xsink);
579  DLLLOCAL void addFile(char* f);
580  DLLLOCAL QoreListNode* getVarList();
581  DLLLOCAL void parseSetIncludePath(const char* path);
582  DLLLOCAL const char* parseGetIncludePath() const;
583 
584  /* for run-time module loading; the parse lock must be grabbed
585  before loading new modules - note this should only be assigned
586  to an AutoLock or SafeLocker object!
587  */
588  DLLLOCAL QoreThreadLock *getParseLock();
589  DLLLOCAL QoreHashNode* clearThreadData(ExceptionSink* xsink);
590  DLLLOCAL const LVList* getTopLevelLVList() const;
591 
593 
595  DLLLOCAL const char* parseGetScriptDir() const;
596 
597  // can only be called while parsing from the same thread doing the parsing
598  DLLLOCAL bool parseExceptionRaised() const;
599 };
600 
602 
605 private:
606  QoreProgram* pgm;
607  ExceptionSink& xsink;
608 
609 public:
611  DLLLOCAL QoreProgramHelper(ExceptionSink& xs) : pgm(new QoreProgram), xsink(xs) {
612  }
613 
615  DLLLOCAL QoreProgramHelper(int64 parse_options, ExceptionSink& xs) : pgm(new QoreProgram(parse_options)), xsink(xs) {
616  }
617 
619 
621  DLLLOCAL ~QoreProgramHelper() {
622  // waits for all background threads to execute
623  thread_counter.waitForZero(&xsink);
624  // waits for the current Program to terminate
625  pgm->waitForTerminationAndDeref(&xsink);
626  }
627 
629  DLLLOCAL QoreProgram* operator->() { return pgm; }
630 
632  DLLLOCAL QoreProgram* operator*() { return pgm; }
633 };
634 
635 #endif // _QORE_QOREPROGRAM_H