Qore Programming Language 1.19.5
Loading...
Searching...
No Matches
QoreObject.h
1/* -*- mode: c++; indent-tabs-mode: nil -*- */
2/*
3 QoreObject.h
4
5 thread-safe object definition
6
7 Qore Programming Language
8
9 Copyright (C) 2003 - 2023 Qore Technologies, s.r.o.
10
11 Permission is hereby granted, free of charge, to any person obtaining a
12 copy of this software and associated documentation files (the "Software"),
13 to deal in the Software without restriction, including without limitation
14 the rights to use, copy, modify, merge, publish, distribute, sublicense,
15 and/or sell copies of the Software, and to permit persons to whom the
16 Software is furnished to do so, subject to the following conditions:
17
18 The above copyright notice and this permission notice shall be included in
19 all copies or substantial portions of the Software.
20
21 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
26 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27 DEALINGS IN THE SOFTWARE.
28
29 Note that the Qore library is released under a choice of three open-source
30 licenses: MIT (as above), LGPL 2+, or GPL 2+; see README-LICENSE for more
31 information.
32*/
33
34#ifndef _QORE_QOREOBJECT_H
35
36#define _QORE_QOREOBJECT_H
37
38class AutoVLock;
39class VRMutex;
40class BuiltinCopy;
41class BuiltinNormalMethodVariantBase;
42class BuiltinCopyVariantBase;
44class QoreProgram;
45class ReferenceNode;
46
48
62 friend class qore_object_private;
63 friend class ObjectRSetHelper;
64 friend class ObjectRSet;
65 friend class qore_object_dereference_helper;
66
67public:
69
73 DLLEXPORT QoreObject(const QoreClass* oc, QoreProgram* p);
74
76
81 DLLEXPORT QoreObject(const QoreClass* oc, QoreProgram* p, AbstractPrivateData* data);
82
84 DLLEXPORT bool hasMember(const char* mem, ExceptionSink* xsink) const;
85
87
89 DLLEXPORT virtual bool getAsBoolImpl() const;
90
92
98 DLLEXPORT virtual int getAsString(QoreString &str, int foff, ExceptionSink* xsink) const;
99
101
108 DLLEXPORT virtual QoreString* getAsString(bool& del, int foff, ExceptionSink* xsink) const;
109
111 DLLEXPORT virtual AbstractQoreNode* realCopy() const;
112
114
118 DLLEXPORT virtual bool is_equal_soft(const AbstractQoreNode* v, ExceptionSink* xsink) const;
119
121
125 DLLEXPORT virtual bool is_equal_hard(const AbstractQoreNode* v, ExceptionSink* xsink) const;
126
128 DLLEXPORT virtual const char* getTypeName() const;
129
131 DLLLOCAL static const char* getStaticTypeName() {
132 return "object";
133 }
134
136 DLLLOCAL static qore_type_t getStaticTypeCode() {
137 return NT_OBJECT;
138 }
139
141
145 DLLEXPORT bool validInstanceOf(qore_classid_t cid) const;
146
148
150 DLLEXPORT bool validInstanceOf(const QoreClass& qc) const;
151
153
157 DLLEXPORT bool validInstanceOfStrict(const QoreClass& qc) const;
158
160
165 DLLEXPORT void setValue(const char* key, QoreValue val, ExceptionSink* xsink);
166
168
171 DLLEXPORT QoreListNode* getMemberList(ExceptionSink* xsink) const;
172
174
178 DLLEXPORT void deleteMemberValue(const QoreString* key, ExceptionSink* xsink);
179
181
185 DLLEXPORT void deleteMemberValue(const char* key, ExceptionSink* xsink);
186
188
192 DLLEXPORT void removeMember(const QoreString* key, ExceptionSink* xsink);
193
195
199 DLLEXPORT void removeMember(const char* key, ExceptionSink* xsink);
200
202
207 DLLEXPORT QoreValue takeMember(const QoreString* key, ExceptionSink* xsink);
208
210
215 DLLEXPORT QoreValue takeMember(const char* key, ExceptionSink* xsink);
216
218
221 DLLEXPORT int size(ExceptionSink* xsink) const;
222
224
228 DLLEXPORT bool compareSoft(const QoreObject* obj, ExceptionSink* xsink) const;
229
231
235 DLLEXPORT bool compareHard(const QoreObject* obj, ExceptionSink* xsink) const;
236
238
243 DLLEXPORT QoreValue getReferencedMemberNoMethod(const char* mem, ExceptionSink* xsink) const;
244
246
252 DLLEXPORT ReferenceNode* getReferenceToMember(const char* mem, ExceptionSink* xsink);
253
255
261 DLLEXPORT int64 getMemberAsBigInt(const char* mem, bool& found, ExceptionSink* xsink) const;
262
264
267 DLLEXPORT QoreHashNode* copyData(ExceptionSink* xsink) const;
268
270
275
277
282
284
289 template <class T>
292 assert(!rv || dynamic_cast<T*>(rv));
293 return reinterpret_cast<T*>(rv);
294 }
295
297
304
306
312 template <class T>
315 assert(!rv || dynamic_cast<T*>(rv));
316 return reinterpret_cast<T*>(rv);
317 }
318
320
325 DLLEXPORT QoreValue evalMethod(const QoreString* name, const QoreListNode* args, ExceptionSink* xsink);
326
328
333 DLLEXPORT QoreValue evalMethod(const char* name, const QoreListNode* args, ExceptionSink* xsink);
334
336
341 DLLEXPORT QoreValue evalMethod(const QoreMethod& method, const QoreListNode* args, ExceptionSink* xsink);
342
344
355 DLLEXPORT QoreValue evalMethod(const char* name, const QoreClass* class_ctx, const QoreListNode* args,
356 ExceptionSink* xsink);
357
359
369 DLLEXPORT QoreValue evalMethod(const QoreMethod& method, const QoreClass* class_ctx, const QoreListNode* args, ExceptionSink* xsink);
370
372
375 DLLEXPORT void doDelete(ExceptionSink* xsink);
376
378
382 DLLEXPORT const QoreClass* getClass(qore_classid_t cid) const;
383
385
392 DLLEXPORT const QoreClass* getClass(qore_classid_t cid, bool& priv) const;
393
395
401 DLLEXPORT ClassAccess getClassAccess(const QoreClass& cls) const;
402
404
407 DLLEXPORT const QoreClass* getClass() const;
408
410
413 DLLEXPORT const char* getClassName() const;
414
416
423 DLLEXPORT const QoreClass* getSurfaceClass() const;
424
426
433 DLLEXPORT const char* getSurfaceClassName() const;
434
436
439 DLLEXPORT bool isValid() const;
440
442
445 DLLEXPORT QoreProgram* getProgram() const;
446
448
451 DLLEXPORT bool isSystemObject() const;
452
454
459 DLLEXPORT void tRef() const;
460
462
465 DLLEXPORT void tDeref();
466
468 DLLEXPORT void realRef();
469
471 DLLEXPORT void realDeref(ExceptionSink* xsink);
472
474
482 DLLEXPORT QoreValue getMemberValueNoMethod(const QoreString* key, AutoVLock* vl, ExceptionSink* xsink) const;
483
485
491 DLLEXPORT QoreValue getMemberValueNoMethod(const char* key, AutoVLock* vl, ExceptionSink* xsink) const;
492
494
503 DLLEXPORT QoreValue getMemberValueNoMethod(const char* key, const QoreClass* cls, AutoVLock* vl,
504 ExceptionSink* xsink) const;
505
507
513 DLLEXPORT QoreValue getReferencedMemberNoMethod(const char* key, const QoreClass* cls, ExceptionSink* xsink) const;
514
516
525 DLLEXPORT int setMemberValue(const char* key, const QoreClass* cls, const QoreValue val, ExceptionSink* xsink);
526
528
532 DLLEXPORT void externalDelete(qore_classid_t key, ExceptionSink* xsink);
533
535 DLLEXPORT QoreValue evalMethodVariant(const QoreMethod& method, const QoreExternalMethodVariant* variant,
536 const QoreListNode* args, ExceptionSink* xsink);
537
539
541 DLLEXPORT QoreValue evalMethodVariant(const QoreMethod& method, const QoreClass* class_ctx,
542 const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
543
545
547 DLLEXPORT static QoreValue evalStaticMethod(const QoreMethod& method, const QoreListNode* args, ExceptionSink* xsink);
548
550
552 DLLEXPORT static QoreValue evalStaticMethod(const QoreMethod& method, const QoreClass* class_ctx,
553 const QoreListNode* args, ExceptionSink* xsink);
554
556
558 DLLEXPORT static QoreValue evalStaticMethodVariant(const QoreMethod& method,
559 const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
560
562
564 DLLEXPORT static QoreValue evalStaticMethodVariant(const QoreMethod& method, const QoreClass* class_ctx,
565 const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
566
568
574 DLLEXPORT QoreValue evalMember(const QoreString* member, ExceptionSink* xsink);
575
577
584 DLLEXPORT QoreValue evalMember(const char* member, ExceptionSink* xsink);
585
587
589 DLLLOCAL QoreObject* objectRefSelf() const {
590 ref();
591 return const_cast<QoreObject*>(this);
592 }
593
594 DLLLOCAL int getStatus() const;
595
596 DLLLOCAL class KeyNode* getReferencedPrivateDataNode(qore_classid_t key);
597
599
604
606
613 const BuiltinNormalMethodVariantBase* meth, const QoreListNode* args, ExceptionSink* xsink);
614
616 DLLLOCAL void evalCopyMethodWithPrivateData(const QoreClass &thisclass, const BuiltinCopyVariantBase* meth,
617 QoreObject* self, ExceptionSink* xsink);
618
620
624 DLLLOCAL void addPrivateDataToString(QoreString* str, ExceptionSink* xsink) const;
625
627
630 DLLLOCAL void obliterate(ExceptionSink* xsink);
631
633
638
639 // returns a new hash consisting of just the members of value_list
640 DLLLOCAL QoreHashNode* getSlice(const QoreListNode* value_list, ExceptionSink* xsink) const;
641
643 DLLLOCAL QoreObject(const QoreClass* oc, QoreProgram* p, QoreHashNode* d);
644
646 DLLLOCAL bool hasMemberNotification() const;
647
649 DLLLOCAL void execMemberNotification(const char* member, ExceptionSink* xsink);
650
651protected:
653
657 DLLEXPORT virtual bool derefImpl(ExceptionSink* xsink);
658
660
662 DLLLOCAL virtual QoreValue evalImpl(bool& needs_deref, ExceptionSink* xsink) const;
663
665 DLLLOCAL virtual void customRef() const;
666
668 DLLLOCAL virtual void customDeref(ExceptionSink* xsink);
669
671 DLLLOCAL virtual ~QoreObject();
672
673private:
675 class qore_object_private* priv;
676
678 DLLLOCAL QoreObject(const QoreObject&);
679
681 DLLLOCAL QoreObject& operator=(const QoreObject&);
682};
683
685
688public:
689 DLLLOCAL QoreObjectWeakRefHolder() {
690 }
691
692 DLLLOCAL QoreObjectWeakRefHolder(QoreObject* obj) : obj(obj) {
693 if (obj) {
694 obj->tRef();
695 }
696 }
697
698 DLLLOCAL ~QoreObjectWeakRefHolder() {
699 discard();
700 }
701
702 DLLLOCAL QoreObject* release() {
703 QoreObject* rv = obj;
704 obj = nullptr;
705 return rv;
706 }
707
708 DLLLOCAL void reset(QoreObject* obj = nullptr) {
709 discard();
710 this->obj = obj;
711 }
712
713 DLLLOCAL QoreObject* operator*() {
714 return obj;
715 }
716
717 DLLLOCAL const QoreObject* operator*() const {
718 return obj;
719 }
720
721 DLLLOCAL QoreObject* operator->() {
722 return obj;
723 }
724
725 DLLLOCAL const QoreObject* operator->() const {
726 return obj;
727 }
728
729 DLLLOCAL operator bool() {
730 return (bool)obj;
731 }
732
733 DLLLOCAL operator bool() const {
734 return (bool)obj;
735 }
736
737private:
738 QoreObject* obj = nullptr;
739
740 DLLLOCAL void discard() {
741 if (obj) {
742 obj->tDeref();
743 }
744 }
745
746 void* operator new(size_t) = delete;
748 QoreObjectWeakRefHolder& operator=(QoreObjectWeakRefHolder& orig) = delete;
749};
750
752template <class T>
754public:
755 DLLLOCAL PrivateDataRefHolder(ExceptionSink* xsink) : ReferenceHolder<T>(xsink) {
756 }
757
758 DLLLOCAL PrivateDataRefHolder(const QoreObject* o, qore_classid_t cid, ExceptionSink* xsink) : ReferenceHolder<T>(reinterpret_cast<T*>(o->getReferencedPrivateData(cid, xsink)), xsink) {
759 }
760
762 DLLLOCAL void operator=(T *nv) {
763 if (this->p)
764 this->p->deref(this->xsink);
765 this->p = nv;
766 }
767};
768
770template <class T>
772public:
773 DLLLOCAL TryPrivateDataRefHolder(const QoreObject* o, qore_classid_t cid, ExceptionSink* xsink) : ReferenceHolder<T>(reinterpret_cast<T*>(o->tryGetReferencedPrivateData(cid, xsink)), xsink) {
774 }
775
777 DLLLOCAL void operator=(T *nv) {
778 if (this->p)
779 this->p->deref(this->xsink);
780 this->p = nv;
781 }
782};
783
784class QorePrivateObjectAccessHelper {
785public:
786 DLLLOCAL QorePrivateObjectAccessHelper(ExceptionSink* xs) : xsink(xs), ptr(0) {
787 }
788
789 DLLLOCAL operator bool() const {
790 return (bool)ptr;
791 }
792
793private:
794 DLLLOCAL QorePrivateObjectAccessHelper(const QorePrivateObjectAccessHelper&) = delete;
795 DLLLOCAL QorePrivateObjectAccessHelper& operator=(const QorePrivateObjectAccessHelper&) = delete;
796 DLLLOCAL void* operator new(size_t) = delete;
797
798protected:
799 ExceptionSink* xsink;
800 void* ptr;
801};
802
803#endif
the base class for all data to be used as private data of Qore objects
Definition: AbstractPrivateData.h:44
The base class for all value and parse types in Qore expression trees.
Definition: AbstractQoreNode.h:57
DLLEXPORT void ref() const
increments the reference count
AutoVLock is a container for safely managing global variable and object lock handovers,...
Definition: AutoVLock.h:80
container for holding Qore-language exception information and also for registering a "thread_exit" ca...
Definition: ExceptionSink.h:50
convenience class for holding AbstractPrivateData references
Definition: QoreObject.h:753
DLLLOCAL void operator=(T *nv)
assigns a new pointer to the holder, dereferences the current pointer if any
Definition: QoreObject.h:762
defines a Qore-language class
Definition: QoreClass.h:257
external wrapper class for method variants
Definition: QoreReflection.h:90
This is the hash or associative list container type in Qore, dynamically allocated only,...
Definition: QoreHashNode.h:51
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreListNode.h:52
a method in a QoreClass
Definition: QoreClass.h:143
the implementation of Qore's object data type, reference counted, dynamically-allocated only
Definition: QoreObject.h:61
DLLLOCAL QoreObject(const QoreClass *oc, QoreProgram *p, QoreHashNode *d)
creates the object with the initial data passed as "d", used by the copy constructor
virtual DLLEXPORT bool derefImpl(ExceptionSink *xsink)
runs the destructor if necessary and dereferences all members
DLLEXPORT AbstractPrivateData * getReferencedPrivateData(qore_classid_t key, ExceptionSink *xsink) const
returns the private data corresponding to the class ID passed with an incremented reference count,...
virtual DLLEXPORT QoreString * getAsString(bool &del, int foff, ExceptionSink *xsink) const
returns a QoreString giving the verbose string representation of the List (including all contained va...
DLLLOCAL bool hasMemberNotification() const
returns true if the class has a memberNotification method
DLLEXPORT const QoreClass * getClass(qore_classid_t cid, bool &priv) const
returns a pointer to the QoreClass object representing the class ID passed if it exists in the class ...
DLLEXPORT const char * getSurfaceClassName() const
returns the name of the class or to the name of the injection target class in case the class was inje...
DLLLOCAL T * getReferencedPrivateData(qore_classid_t key, ExceptionSink *xsink) const
returns the private data corresponding to the class ID passed with an incremented reference count,...
Definition: QoreObject.h:290
DLLEXPORT void tRef() const
increments the existence reference count
DLLEXPORT QoreObject(const QoreClass *oc, QoreProgram *p, AbstractPrivateData *data)
creates an object as belonging to the given class, the QoreProgram object is referenced for the life ...
DLLLOCAL QoreObject * objectRefSelf() const
Returns the object with the reference count increased.
Definition: QoreObject.h:589
DLLLOCAL QoreValue evalBuiltinMethodWithPrivateData(const QoreMethod &method, const BuiltinNormalMethodVariantBase *meth, const QoreListNode *args, ExceptionSink *xsink)
called to evaluate a builtin method when private data is available
DLLEXPORT bool compareSoft(const QoreObject *obj, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) with possible type conversion of c...
DLLEXPORT QoreValue getMemberValueNoMethod(const char *key, const QoreClass *cls, AutoVLock *vl, ExceptionSink *xsink) const
returns the pointer to the value of the member
virtual DLLLOCAL void customRef() const
custom reference handler
DLLEXPORT QoreValue evalMember(const QoreString *member, ExceptionSink *xsink)
returns the value of the member with an incremented reference count, or executes the memberGate() met...
virtual DLLLOCAL void customDeref(ExceptionSink *xsink)
custom dereference handler - with delete
DLLEXPORT void tDeref()
decrements the existence reference count, when it reaches 0 the C++ object ("this") will be deleted
virtual DLLEXPORT int getAsString(QoreString &str, int foff, ExceptionSink *xsink) const
concatenate the verbose string representation of the list (including all contained values) to an exis...
DLLEXPORT QoreValue evalMethod(const QoreString *name, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the arguments passed and returns the return value,...
DLLEXPORT bool isValid() const
returns true if the object is valid
DLLEXPORT bool isSystemObject() const
returns true if the object is a system object (created with the system constructor)
DLLEXPORT void removeMember(const QoreString *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors; the value is only dereferenc...
DLLEXPORT void realDeref(ExceptionSink *xsink)
decrements the standard reference count of the object for references that cannot be part of a recursi...
DLLEXPORT void removeMember(const char *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors; the value is only dereferenc...
DLLEXPORT bool compareHard(const QoreObject *obj, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) with possible type conversion of c...
DLLEXPORT int size(ExceptionSink *xsink) const
returns the number of members of the object
virtual DLLLOCAL ~QoreObject()
destructor
DLLEXPORT void deleteMemberValue(const char *key, ExceptionSink *xsink)
removes a member from the object, if the member's value is an object it is deleted as well (destructo...
static DLLEXPORT QoreValue evalStaticMethod(const QoreMethod &method, const QoreClass *class_ctx, const QoreListNode *args, ExceptionSink *xsink)
executes a static method with the given class context to access private:internal methods
DLLEXPORT QoreValue getReferencedMemberNoMethod(const char *key, const QoreClass *cls, ExceptionSink *xsink) const
returns the value of the given member as accessed from the given class; caller owns any reference ret...
DLLLOCAL void defaultSystemDestructor(qore_classid_t classID, ExceptionSink *xsink)
runs the destructor for system objects
DLLEXPORT const QoreClass * getClass() const
returns a pointer to the QoreClass of this object
DLLEXPORT void setValue(const char *key, QoreValue val, ExceptionSink *xsink)
sets the value of the given member to the given value
static DLLLOCAL const char * getStaticTypeName()
returns the type name (useful in templates)
Definition: QoreObject.h:131
static DLLLOCAL qore_type_t getStaticTypeCode()
returns the type code (useful in templates)
Definition: QoreObject.h:136
DLLLOCAL void addPrivateDataToString(QoreString *str, ExceptionSink *xsink) const
concatenates info about private data to a string
DLLLOCAL void execMemberNotification(const char *member, ExceptionSink *xsink)
executes the member notification on the object the given member
DLLEXPORT QoreValue getMemberValueNoMethod(const QoreString *key, AutoVLock *vl, ExceptionSink *xsink) const
returns the pointer to the value of the member
static DLLEXPORT QoreValue evalStaticMethodVariant(const QoreMethod &method, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a static method variant
DLLEXPORT bool validInstanceOf(const QoreClass &qc) const
returns true if this object is a valid instance of the classid passed
DLLEXPORT void deleteMemberValue(const QoreString *key, ExceptionSink *xsink)
removes a member from the object, if the member's value is an object it is deleted as well (destructo...
DLLEXPORT QoreValue takeMember(const char *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors and returns the value removed...
DLLEXPORT QoreValue evalMethodVariant(const QoreMethod &method, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a normal object method variant
DLLLOCAL void evalCopyMethodWithPrivateData(const QoreClass &thisclass, const BuiltinCopyVariantBase *meth, QoreObject *self, ExceptionSink *xsink)
called on the old object (this) to acquire private data, copy method called with pointer to "self" (n...
DLLLOCAL void obliterate(ExceptionSink *xsink)
destroys all members and dereferences all private data structures
DLLEXPORT void doDelete(ExceptionSink *xsink)
runs the destructor on the object (if it hasn't already been deleted)
DLLEXPORT QoreValue getReferencedMemberNoMethod(const char *mem, ExceptionSink *xsink) const
returns the value of the given member with the reference count incremented, the caller owns any refer...
DLLEXPORT QoreValue evalMember(const char *member, ExceptionSink *xsink)
returns the value of the member with an incremented reference count, or executes the memberGate() met...
DLLLOCAL AbstractPrivateData * getAndClearPrivateData(qore_classid_t key, ExceptionSink *xsink)
retrieves the private data pointer and clears it from the object's private data store,...
DLLEXPORT bool validInstanceOf(qore_classid_t cid) const
returns true if this object is a valid instance of the classid passed
DLLEXPORT void externalDelete(qore_classid_t key, ExceptionSink *xsink)
call this function when an object's private data is deleted externally
static DLLEXPORT QoreValue evalStaticMethod(const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
executes a static method
DLLEXPORT QoreValue getMemberValueNoMethod(const char *key, AutoVLock *vl, ExceptionSink *xsink) const
returns the pointer to the value of the member
DLLEXPORT ClassAccess getClassAccess(const QoreClass &cls) const
returns the accessibility of the class in the object's hierachy or Inaccessible the object does not i...
DLLLOCAL T * tryGetReferencedPrivateData(qore_classid_t key, ExceptionSink *xsink) const
returns the private data corresponding to the class ID passed with an incremented reference count if ...
Definition: QoreObject.h:313
virtual DLLEXPORT const char * getTypeName() const
returns the type name as a c string
DLLEXPORT QoreListNode * getMemberList(ExceptionSink *xsink) const
returns the list of members, caller owns the list returned
DLLEXPORT void setPrivate(qore_classid_t key, AbstractPrivateData *pd)
sets private data for the object against the class ID passed, used in C++ functions implementing Qore...
DLLEXPORT QoreValue evalMethodVariant(const QoreMethod &method, const QoreClass *class_ctx, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a normal object method variant
virtual DLLEXPORT bool is_equal_hard(const AbstractQoreNode *v, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) without type conversions (hard com...
DLLEXPORT QoreProgram * getProgram() const
returns the QoreProgram object associated with this object
DLLEXPORT QoreHashNode * copyData(ExceptionSink *xsink) const
retuns all member data of the object (or 0 if there's an exception), caller owns the QoreHashNode ref...
DLLEXPORT QoreValue evalMethod(const QoreMethod &method, const QoreClass *class_ctx, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the given class context and arguments passed and returns the return v...
DLLEXPORT bool validInstanceOfStrict(const QoreClass &qc) const
returns true if this object is a valid instance of the classid passed; does not check for injected co...
DLLEXPORT int64 getMemberAsBigInt(const char *mem, bool &found, ExceptionSink *xsink) const
returns the value of the given member as an int64
DLLEXPORT QoreValue evalMethod(const char *name, const QoreClass *class_ctx, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the given class context and arguments passed and returns the return v...
DLLEXPORT QoreValue evalMethod(const char *name, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the arguments passed and returns the return value,...
DLLEXPORT AbstractPrivateData * tryGetReferencedPrivateData(qore_classid_t key, ExceptionSink *xsink) const
returns the private data corresponding to the class ID passed with an incremented reference count if ...
static DLLEXPORT QoreValue evalStaticMethodVariant(const QoreMethod &method, const QoreClass *class_ctx, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a static method variant with the given class context to access private:internal methods
DLLEXPORT QoreValue evalMethod(const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the arguments passed and returns the return value,...
DLLEXPORT QoreValue takeMember(const QoreString *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors and returns the value removed...
DLLEXPORT const QoreClass * getSurfaceClass() const
returns a pointer to the QoreClass of this object or to the injection target class in case the class ...
virtual DLLEXPORT AbstractQoreNode * realCopy() const
performs a the same object with its reference count increased
DLLEXPORT void realRef()
increments the standard reference count of the object for references that cannot be part of a recursi...
DLLEXPORT ReferenceNode * getReferenceToMember(const char *mem, ExceptionSink *xsink)
Returns a reference to the given member, if the member is valid and accessible.
DLLEXPORT QoreObject(const QoreClass *oc, QoreProgram *p)
creates an object as belonging to the given class, the QoreProgram object is referenced for the life ...
virtual DLLEXPORT bool is_equal_soft(const AbstractQoreNode *v, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) with possible type conversion (sof...
DLLEXPORT const char * getClassName() const
returns the name of the class
DLLEXPORT int setMemberValue(const char *key, const QoreClass *cls, const QoreValue val, ExceptionSink *xsink)
sets the value of the given member as accessed from the given class
DLLEXPORT bool hasMember(const char *mem, ExceptionSink *xsink) const
returns true if the object has the given member (note that the member may not have a value)
virtual DLLLOCAL QoreValue evalImpl(bool &needs_deref, ExceptionSink *xsink) const
should never be called, does nothing
virtual DLLEXPORT bool getAsBoolImpl() const
returns false unless perl-boolean-evaluation is enabled, in which case it returns false only when emp...
DLLEXPORT const QoreClass * getClass(qore_classid_t cid) const
returns a pointer to a QoreClass object if the class ID passed is a valid class in the hierarchy
Convenience class for holding temporary / weak references to objects.
Definition: QoreObject.h:687
supports parsing and executing Qore-language code, reference counted, dynamically-allocated only
Definition: QoreProgram.h:128
Qore's string type supported by the QoreEncoding class.
Definition: QoreString.h:93
a templated class to manage a reference count of an object that can throw a Qore-language exception w...
Definition: ReferenceHolder.h:52
parse type: reference to a lvalue expression
Definition: ReferenceNode.h:45
convenience class for holding AbstractPrivateData references
Definition: QoreObject.h:771
DLLLOCAL void operator=(T *nv)
assigns a new pointer to the holder, dereferences the current pointer if any
Definition: QoreObject.h:777
int16_t qore_type_t
used to identify unique Qore data and parse types (descendents of AbstractQoreNode)
Definition: common.h:70
unsigned qore_classid_t
used for the unique class ID for QoreClass objects
Definition: common.h:79
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
const qore_type_t NT_OBJECT
type value for QoreObject
Definition: node_types.h:52
The main value class in Qore, designed to be passed by value.
Definition: QoreValue.h:279