Qore Programming Language - C/C++ Library  0.9.4.6
QoreNamespace.h
1 /* -*- mode: c++; indent-tabs-mode: nil -*- */
2 /*
3  QoreNamespace.h
4 
5  Qore Programming Language
6 
7  Copyright (C) 2003 - 2018 Qore Technologies, s.r.o.
8 
9  Permission is hereby granted, free of charge, to any person obtaining a
10  copy of this software and associated documentation files (the "Software"),
11  to deal in the Software without restriction, including without limitation
12  the rights to use, copy, modify, merge, publish, distribute, sublicense,
13  and/or sell copies of the Software, and to permit persons to whom the
14  Software is furnished to do so, subject to the following conditions:
15 
16  The above copyright notice and this permission notice shall be included in
17  all copies or substantial portions of the Software.
18 
19  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25  DEALINGS IN THE SOFTWARE.
26 
27  Note that the Qore library is released under a choice of three open-source
28  licenses: MIT (as above), LGPL 2+, or GPL 2+; see README-LICENSE for more
29  information.
30 */
31 
32 /*
33  namespaces are children of a program object. there is a parse
34  lock per program object to ensure that objects are added (or backed out)
35  atomically per program object. All the objects referenced here should
36  be safe to read & copied at all times. They will only be deleted when the
37  program object is deleted (except the pending structures, which will be
38  deleted any time there is a parse error, together with all other
39  pending structures)
40 */
41 
42 #ifndef _QORE_QORENAMESPACE_H
43 
44 #define _QORE_QORENAMESPACE_H
45 
46 #include <cstdlib>
47 #include <cstring>
48 #include <string>
49 
50 // forward declarations
51 class QoreExternalFunction;
53 class QoreExternalGlobalVar;
54 
56 
61 typedef QoreClass* (*q_ns_class_handler_t)(QoreNamespace* ns, const char* cname);
62 
65  friend class QoreNamespaceList;
66  friend class RootQoreNamespace;
67  friend class qore_ns_private;
68  friend class qore_root_ns_private;
69  friend struct NSOInfoBase;
70 
71 public:
73 
76  DLLEXPORT QoreNamespace(const char* n);
77 
79  DLLEXPORT virtual ~QoreNamespace();
80 
82 
86  DLLEXPORT void clear(ExceptionSink* xsink);
87 
89 
95  DLLEXPORT void addConstant(const char* name, QoreValue value);
96 
98 
104  DLLEXPORT void addConstant(const char* name, QoreValue value, const QoreTypeInfo* typeInfo);
105 
107 
110  DLLEXPORT void addSystemClass(QoreClass* oc);
111 
113 
118  DLLEXPORT void addSystemHashDecl(TypedHashDecl* hashdecl);
119 
121 
124  DLLEXPORT QoreNamespace* copy(int po) const;
125 
127 
130  DLLEXPORT QoreNamespace* copy(int64 po = PO_DEFAULT) const;
131 
133 
138  DLLEXPORT QoreHashNode* getClassInfo() const;
139 
141 
146  DLLEXPORT QoreHashNode* getConstantInfo() const;
147 
149 
155  DLLEXPORT QoreHashNode* getInfo() const;
156 
158 
161  DLLEXPORT const char* getName() const;
162 
164 
167  DLLEXPORT void addNamespace(QoreNamespace* ns);
168 
170 
175  DLLEXPORT void addInitialNamespace(QoreNamespace* ns);
176 
178 
186  DLLEXPORT QoreNamespace* findCreateNamespacePath(const char* nspath);
187 
189 
194  DLLEXPORT QoreClass* findLocalClass(const char* cname) const;
195 
197 
201  DLLEXPORT QoreNamespace* findLocalNamespace(const char* nsname) const;
202 
204 
207  DLLEXPORT void setClassHandler(q_ns_class_handler_t class_handler);
208 
210 
212  DLLEXPORT const QoreNamespace* getParent() const;
213 
215  DLLEXPORT void deleteData(ExceptionSink* xsink);
216 
218  DLLEXPORT void addBuiltinVariant(const char* name, q_func_n_t f, int64 code_flags = QCF_NO_FLAGS, int64 functional_domain = QDOM_DEFAULT, const QoreTypeInfo* returnTypeInfo = 0, unsigned num_params = 0, ...);
219 
221 
223  DLLEXPORT const QoreExternalFunction* findLocalFunction(const char* name) const;
224 
226 
228  DLLEXPORT const QoreExternalConstant* findLocalConstant(const char* name) const;
229 
231 
233  DLLEXPORT const QoreExternalGlobalVar* findLocalGlobalVar(const char* name) const;
234 
236 
238  DLLEXPORT const TypedHashDecl* findLocalTypedHash(const char* name) const;
239 
241 
245  DLLEXPORT std::string getPath(bool anchored = false) const;
246 
248 
250  DLLEXPORT bool isModulePublic() const;
251 
253 
255  DLLEXPORT bool isBuiltin() const;
256 
258 
260  DLLEXPORT bool isImported() const;
261 
263 
265  DLLEXPORT bool isRoot() const;
266 
267 private:
269  QoreNamespace(const QoreNamespace&) = delete;
270 
272  QoreNamespace& operator=(const QoreNamespace&) = delete;
273 
274 protected:
275  class qore_ns_private* priv; // private implementation
276 
277  // protected, function not exported in the API
278  DLLLOCAL QoreNamespace(qore_ns_private* p);
279 };
280 
282 
287  friend class qore_ns_private;
288  friend class qore_root_ns_private;
289  friend class StaticSystemNamespace;
290 
291 public:
293 
297 
299  DLLLOCAL virtual ~RootQoreNamespace();
300 
301 protected:
302  // private implementation
303  class qore_root_ns_private* rpriv;
304 
305 private:
307  RootQoreNamespace(const RootQoreNamespace&) = delete;
308 
310  RootQoreNamespace& operator=(const RootQoreNamespace&) = delete;
311 
312  DLLLOCAL RootQoreNamespace(class qore_root_ns_private* p);
313 };
314 
315 class QorePrivateNamespaceIterator;
316 
318 
321 public:
324 
326  DLLEXPORT virtual ~QoreNamespaceIterator();
327 
329  DLLEXPORT bool next();
330 
332  DLLEXPORT QoreNamespace* operator->();
333 
335  DLLEXPORT QoreNamespace* operator*();
336 
338  DLLEXPORT QoreNamespace& get();
339 
341  DLLEXPORT const QoreNamespace* operator->() const;
343  DLLEXPORT const QoreNamespace* operator*() const;
344 
346  DLLEXPORT const QoreNamespace& get() const;
347 
348 private:
351 
353  QoreNamespaceIterator& operator=(const QoreNamespaceIterator&) = delete;
354 
355  QorePrivateNamespaceIterator* priv;
356 };
357 
359 
362 public:
365 
367  DLLEXPORT virtual ~QoreNamespaceConstIterator();
368 
370  DLLEXPORT bool next();
371 
373  DLLEXPORT const QoreNamespace* operator->() const;
374 
376  DLLEXPORT const QoreNamespace* operator*() const;
377 
379  DLLEXPORT const QoreNamespace& get() const;
380 
381 private:
384 
386  QoreNamespaceConstIterator& operator=(const QoreNamespaceConstIterator&) = delete;
387 
388  QorePrivateNamespaceIterator* priv;
389 };
390 
392 
395 public:
398 
400  DLLEXPORT virtual ~QoreNamespaceNamespaceIterator();
401 
403  DLLEXPORT bool next();
404 
406  DLLEXPORT const QoreNamespace& get() const;
407 
408 private:
411 
414 
415  class qore_namespace_namespace_iterator* priv;
416 };
417 
419 
422 public:
425 
427  DLLEXPORT virtual ~QoreNamespaceFunctionIterator();
428 
430  DLLEXPORT bool next();
431 
433  DLLEXPORT const QoreExternalFunction& get() const;
434 
435 private:
438 
441 
442  class qore_namespace_function_iterator* priv;
443 };
444 
446 
449 public:
452 
454  DLLEXPORT virtual ~QoreNamespaceConstantIterator();
455 
457  DLLEXPORT bool next();
458 
460  DLLEXPORT const QoreExternalConstant& get() const;
461 
462 private:
465 
468 
469  class qore_namespace_constant_iterator* priv;
470 };
471 
473 
476 public:
479 
481  DLLEXPORT virtual ~QoreNamespaceClassIterator();
482 
484  DLLEXPORT bool next();
485 
487  DLLEXPORT const QoreClass& get() const;
488 
489 private:
492 
494  QoreNamespaceClassIterator& operator=(const QoreNamespaceClassIterator&) = delete;
495 
496  class ConstClassListIterator* priv;
497 };
498 
500 
503 public:
506 
508  DLLEXPORT virtual ~QoreNamespaceGlobalVarIterator();
509 
511  DLLEXPORT bool next();
512 
514  DLLEXPORT const QoreExternalGlobalVar& get() const;
515 
516 private:
519 
522 
523  class qore_namespace_globalvar_iterator* priv;
524 };
525 
527 
530 public:
533 
535  DLLEXPORT virtual ~QoreNamespaceTypedHashIterator();
536 
538  DLLEXPORT bool next();
539 
541  DLLEXPORT const TypedHashDecl& get() const;
542 
543 private:
546 
549 
550  class ConstHashDeclListIterator* priv;
551 };
552 
553 #endif // QORE_NAMESPACE_H
QoreNamespaceClassIterator::QoreNamespaceClassIterator
DLLEXPORT QoreNamespaceClassIterator(const QoreNamespace &ns)
creates the iterator
QoreNamespace::addSystemHashDecl
DLLEXPORT void addSystemHashDecl(TypedHashDecl *hashdecl)
adds a hashdecl to a namespace
PO_DEFAULT
#define PO_DEFAULT
no parse options set by default
Definition: Restrictions.h:105
QoreNamespace::isBuiltin
DLLEXPORT bool isBuiltin() const
returns true if the namespace is builtin
QoreNamespaceTypedHashIterator::~QoreNamespaceTypedHashIterator
virtual DLLEXPORT ~QoreNamespaceTypedHashIterator()
destroys the object
QoreNamespaceConstIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
q_func_n_t
QoreValue(* q_func_n_t)(const QoreListNode *args, q_rt_flags_t flags, ExceptionSink *xsink)
the type used for builtin function signatures
Definition: common.h:307
QoreNamespaceConstantIterator::get
DLLEXPORT const QoreExternalConstant & get() const
returns the constant
QoreNamespaceTypedHashIterator
allows typed hashes (hashdecls) in a namespace to be iterated
Definition: QoreNamespace.h:529
QoreValue
The main value class in Qore, designed to be passed by value.
Definition: QoreValue.h:262
QDOM_DEFAULT
#define QDOM_DEFAULT
the default domain (no domain)
Definition: Restrictions.h:155
QoreHashNode
This is the hash or associative list container type in Qore, dynamically allocated only,...
Definition: QoreHashNode.h:50
QoreNamespaceIterator::~QoreNamespaceIterator
virtual DLLEXPORT ~QoreNamespaceIterator()
destroys the object
QoreNamespaceConstantIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
QoreNamespaceClassIterator::get
DLLEXPORT const QoreClass & get() const
returns the class
QoreNamespaceConstIterator::QoreNamespaceConstIterator
DLLEXPORT QoreNamespaceConstIterator(const QoreNamespace &ns)
creates the iterator; the namespace given will also be included in the iteration set
QoreNamespaceFunctionIterator
allows functions in a namespace to be iterated
Definition: QoreNamespace.h:421
QoreNamespaceConstIterator::operator->
DLLEXPORT const QoreNamespace * operator->() const
returns the namespace
QoreNamespaceClassIterator::~QoreNamespaceClassIterator
virtual DLLEXPORT ~QoreNamespaceClassIterator()
destroys the object
QoreClass
defines a Qore-language class
Definition: QoreClass.h:239
QoreNamespace::addConstant
DLLEXPORT void addConstant(const char *name, QoreValue value)
adds a constant definition to the namespace
QoreNamespace::findLocalFunction
DLLEXPORT const QoreExternalFunction * findLocalFunction(const char *name) const
find a function in the current namespace; returns nullptr if not found
QoreNamespace::addBuiltinVariant
DLLEXPORT void addBuiltinVariant(const char *name, q_func_n_t f, int64 code_flags=QCF_NO_FLAGS, int64 functional_domain=QDOM_DEFAULT, const QoreTypeInfo *returnTypeInfo=0, unsigned num_params=0,...)
adds a function variant
QoreNamespaceConstIterator::~QoreNamespaceConstIterator
virtual DLLEXPORT ~QoreNamespaceConstIterator()
destroys the object
QoreNamespace::getInfo
DLLEXPORT QoreHashNode * getInfo() const
returns a hash giving information about the definitions in the namespace
QoreNamespace::getParent
DLLEXPORT const QoreNamespace * getParent() const
returns a pointer to the parent namespace or nullptr if there is no parent
QoreNamespace::findLocalClass
DLLEXPORT QoreClass * findLocalClass(const char *cname) const
finds a class in this namespace, does not search child namespaces
QoreNamespace::getPath
DLLEXPORT std::string getPath(bool anchored=false) const
returns the path for the namespace
QoreNamespaceConstantIterator::QoreNamespaceConstantIterator
DLLEXPORT QoreNamespaceConstantIterator(const QoreNamespace &ns)
creates the iterator
QoreNamespaceNamespaceIterator::get
DLLEXPORT const QoreNamespace & get() const
returns the namespace
QoreNamespace::copy
DLLEXPORT QoreNamespace * copy(int po) const
returns a deep copy of the namespace; DEPRECATED: use copy(int64) instead
QoreNamespaceIterator::QoreNamespaceIterator
DLLEXPORT QoreNamespaceIterator(QoreNamespace &ns)
creates the iterator; the namespace given will also be included in the iteration set
int64
long long int64
64bit integer type, cannot use int64_t here since it breaks the API on some 64-bit systems due to equ...
Definition: common.h:260
QoreNamespaceNamespaceIterator::QoreNamespaceNamespaceIterator
DLLEXPORT QoreNamespaceNamespaceIterator(const QoreNamespace &ns)
creates the iterator
QoreNamespaceIterator::operator*
DLLEXPORT QoreNamespace * operator*()
returns the namespace
QoreNamespaceIterator::operator->
DLLEXPORT QoreNamespace * operator->()
returns the namespace
QoreNamespace::findLocalGlobalVar
DLLEXPORT const QoreExternalGlobalVar * findLocalGlobalVar(const char *name) const
find a global variable in the current namespace; returns nullptr if not found
QoreNamespaceConstIterator
allows all namespaces of a namespace to be iterated (including the namespace passed in the constructo...
Definition: QoreNamespace.h:361
QoreNamespace
contains constants, classes, and subnamespaces in QoreProgram objects
Definition: QoreNamespace.h:64
QoreNamespace::findLocalNamespace
DLLEXPORT QoreNamespace * findLocalNamespace(const char *nsname) const
finds a subnamespace in this namespace, does not search child namespaces
QoreExternalConstant
external wrapper class for constants
Definition: QoreReflection.h:200
RootQoreNamespace::rootGetQoreNamespace
DLLEXPORT QoreNamespace * rootGetQoreNamespace() const
returns a pointer to the QoreNamespace for the "Qore" namespace
QoreNamespace::~QoreNamespace
virtual DLLEXPORT ~QoreNamespace()
destroys the object and frees memory
QoreNamespace::deleteData
DLLEXPORT void deleteData(ExceptionSink *xsink)
this function must be called before the QoreNamespace object is deleted or a crash could result due i...
QoreNamespaceNamespaceIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
RootQoreNamespace::~RootQoreNamespace
virtual DLLLOCAL ~RootQoreNamespace()
destructor is not exported in the library's public API
QoreNamespace::isRoot
DLLEXPORT bool isRoot() const
returns true if the namespace is the root namespace
QoreNamespaceConstIterator::operator*
DLLEXPORT const QoreNamespace * operator*() const
returns the namespace
QoreNamespace::findLocalTypedHash
DLLEXPORT const TypedHashDecl * findLocalTypedHash(const char *name) const
find a typed hash (hashdecl) in the current namespace; returns nullptr if not found
QoreNamespaceClassIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
TypedHashDecl
typed hash declaration
Definition: TypedHashDecl.h:44
QoreNamespaceFunctionIterator::QoreNamespaceFunctionIterator
DLLEXPORT QoreNamespaceFunctionIterator(const QoreNamespace &ns)
creates the iterator
QoreNamespaceGlobalVarIterator::QoreNamespaceGlobalVarIterator
DLLEXPORT QoreNamespaceGlobalVarIterator(const QoreNamespace &ns)
creates the iterator
QoreNamespaceTypedHashIterator::QoreNamespaceTypedHashIterator
DLLEXPORT QoreNamespaceTypedHashIterator(const QoreNamespace &ns)
creates the iterator
QoreNamespaceFunctionIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
QoreNamespaceIterator::get
DLLEXPORT QoreNamespace & get()
returns the namespace
QoreNamespace::getName
DLLEXPORT const char * getName() const
returns the name of the namespace
QoreNamespace::getConstantInfo
DLLEXPORT QoreHashNode * getConstantInfo() const
a hash of all constants in the namespace, the hash keys are the constant names and the values are the...
ExceptionSink
container for holding Qore-language exception information and also for registering a "thread_exit" ca...
Definition: ExceptionSink.h:46
QoreNamespace::findLocalConstant
DLLEXPORT const QoreExternalConstant * findLocalConstant(const char *name) const
find a constant in the current namespace; returns nullptr if not found
QoreNamespaceFunctionIterator::~QoreNamespaceFunctionIterator
virtual DLLEXPORT ~QoreNamespaceFunctionIterator()
destroys the object
QoreNamespace::setClassHandler
DLLEXPORT void setClassHandler(q_ns_class_handler_t class_handler)
sets the namespace class handler
QoreNamespaceClassIterator
allows classes in a namespace to be iterated
Definition: QoreNamespace.h:475
QoreNamespaceFunctionIterator::get
DLLEXPORT const QoreExternalFunction & get() const
returns the function
QoreNamespaceNamespaceIterator
allows local namespaces to be iterated
Definition: QoreNamespace.h:394
QoreNamespaceNamespaceIterator::~QoreNamespaceNamespaceIterator
virtual DLLEXPORT ~QoreNamespaceNamespaceIterator()
destroys the object
QoreNamespaceGlobalVarIterator::get
DLLEXPORT const QoreExternalGlobalVar & get() const
returns the global variable
QoreNamespace::addNamespace
DLLEXPORT void addNamespace(QoreNamespace *ns)
adds a namespace to the namespace tree
QoreNamespaceConstantIterator::~QoreNamespaceConstantIterator
virtual DLLEXPORT ~QoreNamespaceConstantIterator()
destroys the object
QoreNamespaceGlobalVarIterator::~QoreNamespaceGlobalVarIterator
virtual DLLEXPORT ~QoreNamespaceGlobalVarIterator()
destroys the object
QoreNamespaceGlobalVarIterator
allows global variables in a namespace to be iterated
Definition: QoreNamespace.h:502
QoreNamespace::isModulePublic
DLLEXPORT bool isModulePublic() const
returns true if the namespace has its module public flag set
QoreNamespace::getClassInfo
DLLEXPORT QoreHashNode * getClassInfo() const
gets a hash of all classes in the namespace, the hash keys are the class names and the values are lis...
num_params
static unsigned num_params(const QoreListNode *n)
returns the number of arguments passed to the function
Definition: params.h:54
QoreNamespaceConstIterator::get
DLLEXPORT const QoreNamespace & get() const
returns the namespace
QoreNamespaceTypedHashIterator::get
DLLEXPORT const TypedHashDecl & get() const
returns the typed hash (hashdecl)
QoreNamespace::addInitialNamespace
DLLEXPORT void addInitialNamespace(QoreNamespace *ns)
adds a subnamespace to the namespace
QoreNamespaceConstantIterator
allows constants in a namespace to be iterated
Definition: QoreNamespace.h:448
QoreNamespace::isImported
DLLEXPORT bool isImported() const
returns true if the namespace was imported from another program object
QoreNamespace::findCreateNamespacePath
DLLEXPORT QoreNamespace * findCreateNamespacePath(const char *nspath)
finds a Namespace based on the argument; creates it (or the whole path) if necessary
RootQoreNamespace
the root namespace of a QoreProgram object
Definition: QoreNamespace.h:286
QoreNamespaceIterator
allows all namespaces of a namespace to be iterated (including the namespace passed in the constructo...
Definition: QoreNamespace.h:320
QoreNamespaceTypedHashIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
QoreNamespace::clear
DLLEXPORT void clear(ExceptionSink *xsink)
clears the contents of the namespace before deleting
QoreNamespaceGlobalVarIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
QoreNamespace::QoreNamespace
DLLEXPORT QoreNamespace(const char *n)
creates a namespace with the given name
QoreNamespaceIterator::next
DLLEXPORT bool next()
moves to the next position; returns true if on a valid position
QoreNamespace::addSystemClass
DLLEXPORT void addSystemClass(QoreClass *oc)
adds a class to a namespace