Loading...
Searching...
No Matches
QoreObject.h
/* -*- mode: c++; indent-tabs-mode: nil -*- */
/*
QoreObject.h
thread-safe object definition
Qore Programming Language
Copyright (C) 2003 - 2022 Qore Technologies, s.r.o.
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
Note that the Qore library is released under a choice of three open-source
licenses: MIT (as above), LGPL 2+, or GPL 2+; see README-LICENSE for more
information.
*/
#ifndef _QORE_QOREOBJECT_H
#define _QORE_QOREOBJECT_H
class AutoVLock;
class VRMutex;
class BuiltinCopy;
class BuiltinNormalMethodVariantBase;
class BuiltinCopyVariantBase;
class QoreExternalMethodVariant;
class QoreProgram;
class QoreObject : public AbstractQoreNode {
friend class qore_object_private;
friend class ObjectRSetHelper;
friend class ObjectRSet;
friend class qore_object_dereference_helper;
public:
DLLEXPORT QoreObject(const QoreClass* oc, QoreProgram* p);
DLLEXPORT QoreObject(const QoreClass* oc, QoreProgram* p, AbstractPrivateData* data);
DLLEXPORT bool hasMember(const char* mem, ExceptionSink* xsink) const;
DLLEXPORT virtual bool getAsBoolImpl() const;
DLLEXPORT virtual int getAsString(QoreString &str, int foff, ExceptionSink* xsink) const;
DLLEXPORT virtual QoreString* getAsString(bool& del, int foff, ExceptionSink* xsink) const;
DLLEXPORT virtual AbstractQoreNode* realCopy() const;
DLLEXPORT virtual bool is_equal_soft(const AbstractQoreNode* v, ExceptionSink* xsink) const;
DLLEXPORT virtual bool is_equal_hard(const AbstractQoreNode* v, ExceptionSink* xsink) const;
DLLEXPORT virtual const char* getTypeName() const;
DLLLOCAL static const char* getStaticTypeName() {
return "object";
}
DLLLOCAL static qore_type_t getStaticTypeCode() {
return NT_OBJECT;
}
DLLEXPORT bool validInstanceOf(qore_classid_t cid) const;
DLLEXPORT bool validInstanceOf(const QoreClass& qc) const;
DLLEXPORT bool validInstanceOfStrict(const QoreClass& qc) const;
DLLEXPORT void setValue(const char* key, QoreValue val, ExceptionSink* xsink);
DLLEXPORT QoreListNode* getMemberList(ExceptionSink* xsink) const;
DLLEXPORT void deleteMemberValue(const QoreString* key, ExceptionSink* xsink);
DLLEXPORT void deleteMemberValue(const char* key, ExceptionSink* xsink);
DLLEXPORT void removeMember(const QoreString* key, ExceptionSink* xsink);
DLLEXPORT void removeMember(const char* key, ExceptionSink* xsink);
DLLEXPORT QoreValue takeMember(const QoreString* key, ExceptionSink* xsink);
DLLEXPORT QoreValue takeMember(const char* key, ExceptionSink* xsink);
DLLEXPORT int size(ExceptionSink* xsink) const;
DLLEXPORT bool compareSoft(const QoreObject* obj, ExceptionSink* xsink) const;
DLLEXPORT bool compareHard(const QoreObject* obj, ExceptionSink* xsink) const;
DLLEXPORT QoreValue getReferencedMemberNoMethod(const char* mem, ExceptionSink* xsink) const;
DLLEXPORT int64 getMemberAsBigInt(const char* mem, bool& found, ExceptionSink* xsink) const;
DLLEXPORT QoreHashNode* copyData(ExceptionSink* xsink) const;
DLLEXPORT void setPrivate(qore_classid_t key, AbstractPrivateData* pd);
DLLEXPORT AbstractPrivateData* getReferencedPrivateData(qore_classid_t key, ExceptionSink* xsink) const;
template <class T>
DLLLOCAL T* getReferencedPrivateData(qore_classid_t key, ExceptionSink* xsink) const {
AbstractPrivateData* rv = getReferencedPrivateData(key, xsink);
assert(!rv || dynamic_cast<T*>(rv));
return reinterpret_cast<T*>(rv);
}
DLLEXPORT AbstractPrivateData* tryGetReferencedPrivateData(qore_classid_t key, ExceptionSink* xsink) const;
template <class T>
DLLLOCAL T* tryGetReferencedPrivateData(qore_classid_t key, ExceptionSink* xsink) const {
AbstractPrivateData* rv = tryGetReferencedPrivateData(key, xsink);
assert(!rv || dynamic_cast<T*>(rv));
return reinterpret_cast<T*>(rv);
}
DLLEXPORT QoreValue evalMethod(const QoreString* name, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMethod(const char* name, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMethod(const QoreMethod& method, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMethod(const QoreMethod& method, const QoreClass* class_ctx, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT void doDelete(ExceptionSink* xsink);
DLLEXPORT const QoreClass* getClass(qore_classid_t cid) const;
DLLEXPORT const QoreClass* getClass(qore_classid_t cid, bool& priv) const;
DLLEXPORT ClassAccess getClassAccess(const QoreClass& cls) const;
DLLEXPORT const QoreClass* getClass() const;
DLLEXPORT const char* getClassName() const;
DLLEXPORT const QoreClass* getSurfaceClass() const;
DLLEXPORT const char* getSurfaceClassName() const;
DLLEXPORT bool isValid() const;
DLLEXPORT QoreProgram* getProgram() const;
DLLEXPORT bool isSystemObject() const;
DLLEXPORT void tRef() const;
DLLEXPORT void tDeref();
DLLEXPORT void realRef();
DLLEXPORT void realDeref(ExceptionSink* xsink);
DLLEXPORT QoreValue getMemberValueNoMethod(const QoreString* key, AutoVLock* vl, ExceptionSink* xsink) const;
DLLEXPORT QoreValue getMemberValueNoMethod(const char* key, AutoVLock* vl, ExceptionSink* xsink) const;
DLLEXPORT QoreValue getReferencedMemberNoMethod(const char* key, const QoreClass* cls, ExceptionSink* xsink) const;
DLLEXPORT int setMemberValue(const char* key, const QoreClass* cls, const QoreValue val, ExceptionSink* xsink);
DLLEXPORT void externalDelete(qore_classid_t key, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMethodVariant(const QoreMethod& method, const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMethodVariant(const QoreMethod& method, const QoreClass* class_ctx, const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT static QoreValue evalStaticMethod(const QoreMethod& method, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT static QoreValue evalStaticMethod(const QoreMethod& method, const QoreClass* class_ctx, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT static QoreValue evalStaticMethodVariant(const QoreMethod& method, const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT static QoreValue evalStaticMethodVariant(const QoreMethod& method, const QoreClass* class_ctx, const QoreExternalMethodVariant* variant, const QoreListNode* args, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMember(const QoreString* member, ExceptionSink* xsink);
DLLEXPORT QoreValue evalMember(const char* member, ExceptionSink* xsink);
DLLLOCAL QoreObject* objectRefSelf() const {
ref();
return const_cast<QoreObject*>(this);
}
DLLLOCAL int getStatus() const;
DLLLOCAL class KeyNode* getReferencedPrivateDataNode(qore_classid_t key);
DLLLOCAL AbstractPrivateData* getAndClearPrivateData(qore_classid_t key, ExceptionSink* xsink);
DLLLOCAL QoreValue evalBuiltinMethodWithPrivateData(const QoreMethod& method,
const BuiltinNormalMethodVariantBase* meth, const QoreListNode* args, ExceptionSink* xsink);
DLLLOCAL void evalCopyMethodWithPrivateData(const QoreClass &thisclass, const BuiltinCopyVariantBase* meth,
QoreObject* self, ExceptionSink* xsink);
DLLLOCAL void addPrivateDataToString(QoreString* str, ExceptionSink* xsink) const;
DLLLOCAL void obliterate(ExceptionSink* xsink);
DLLLOCAL void defaultSystemDestructor(qore_classid_t classID, ExceptionSink* xsink);
// returns a new hash consisting of just the members of value_list
DLLLOCAL QoreHashNode* getSlice(const QoreListNode* value_list, ExceptionSink* xsink) const;
DLLLOCAL QoreObject(const QoreClass* oc, QoreProgram* p, QoreHashNode* d);
DLLLOCAL bool hasMemberNotification() const;
DLLLOCAL void execMemberNotification(const char* member, ExceptionSink* xsink);
protected:
DLLEXPORT virtual bool derefImpl(ExceptionSink* xsink);
DLLLOCAL virtual QoreValue evalImpl(bool& needs_deref, ExceptionSink* xsink) const;
DLLLOCAL virtual void customRef() const;
DLLLOCAL virtual void customDeref(ExceptionSink* xsink);
DLLLOCAL virtual ~QoreObject();
private:
class qore_object_private* priv;
DLLLOCAL QoreObject(const QoreObject&);
DLLLOCAL QoreObject& operator=(const QoreObject&);
};
class QoreObjectWeakRefHolder {
public:
DLLLOCAL QoreObjectWeakRefHolder() {
}
DLLLOCAL QoreObjectWeakRefHolder(QoreObject* obj) : obj(obj) {
if (obj) {
obj->tRef();
}
}
DLLLOCAL ~QoreObjectWeakRefHolder() {
discard();
}
DLLLOCAL QoreObject* release() {
QoreObject* rv = obj;
obj = nullptr;
return rv;
}
DLLLOCAL void reset(QoreObject* obj = nullptr) {
discard();
this->obj = obj;
}
DLLLOCAL QoreObject* operator*() {
return obj;
}
DLLLOCAL const QoreObject* operator*() const {
return obj;
}
DLLLOCAL QoreObject* operator->() {
return obj;
}
DLLLOCAL const QoreObject* operator->() const {
return obj;
}
DLLLOCAL operator bool() {
return (bool)obj;
}
DLLLOCAL operator bool() const {
return (bool)obj;
}
private:
QoreObject* obj = nullptr;
DLLLOCAL void discard() {
if (obj) {
obj->tDeref();
}
}
void* operator new(size_t) = delete;
QoreObjectWeakRefHolder(const QoreObjectWeakRefHolder& old) = delete;
QoreObjectWeakRefHolder& operator=(QoreObjectWeakRefHolder& orig) = delete;
};
template <class T>
class PrivateDataRefHolder : public ReferenceHolder<T> {
public:
DLLLOCAL PrivateDataRefHolder(ExceptionSink* xsink) : ReferenceHolder<T>(xsink) {
}
DLLLOCAL PrivateDataRefHolder(const QoreObject* o, qore_classid_t cid, ExceptionSink* xsink) : ReferenceHolder<T>(reinterpret_cast<T*>(o->getReferencedPrivateData(cid, xsink)), xsink) {
}
DLLLOCAL void operator=(T *nv) {
if (this->p)
this->p->deref(this->xsink);
this->p = nv;
}
};
template <class T>
class TryPrivateDataRefHolder : public ReferenceHolder<T> {
public:
DLLLOCAL TryPrivateDataRefHolder(const QoreObject* o, qore_classid_t cid, ExceptionSink* xsink) : ReferenceHolder<T>(reinterpret_cast<T*>(o->tryGetReferencedPrivateData(cid, xsink)), xsink) {
}
DLLLOCAL void operator=(T *nv) {
if (this->p)
this->p->deref(this->xsink);
this->p = nv;
}
};
class QorePrivateObjectAccessHelper {
public:
DLLLOCAL QorePrivateObjectAccessHelper(ExceptionSink* xs) : xsink(xs), ptr(0) {
}
DLLLOCAL operator bool() const {
return (bool)ptr;
}
private:
DLLLOCAL QorePrivateObjectAccessHelper(const QorePrivateObjectAccessHelper&) = delete;
DLLLOCAL QorePrivateObjectAccessHelper& operator=(const QorePrivateObjectAccessHelper&) = delete;
DLLLOCAL void* operator new(size_t) = delete;
protected:
ExceptionSink* xsink;
void* ptr;
};
#endif
AbstractPrivateData
the base class for all data to be used as private data of Qore objects
Definition: AbstractPrivateData.h:44
AbstractQoreNode
The base class for all value and parse types in Qore expression trees.
Definition: AbstractQoreNode.h:57
AbstractQoreNode::ref
DLLEXPORT void ref() const
increments the reference count
AutoVLock
AutoVLock is a container for safely managing global variable and object lock handovers,...
Definition: AutoVLock.h:80
ExceptionSink
container for holding Qore-language exception information and also for registering a "thread_exit" ca...
Definition: ExceptionSink.h:48
PrivateDataRefHolder
convenience class for holding AbstractPrivateData references
Definition: QoreObject.h:710
PrivateDataRefHolder::operator=
DLLLOCAL void operator=(T *nv)
assigns a new pointer to the holder, dereferences the current pointer if any
Definition: QoreObject.h:719
QoreClass
defines a Qore-language class
Definition: QoreClass.h:249
QoreExternalMethodVariant
external wrapper class for method variants
Definition: QoreReflection.h:90
QoreHashNode
This is the hash or associative list container type in Qore, dynamically allocated only,...
Definition: QoreHashNode.h:50
QoreListNode
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreListNode.h:52
QoreMethod
a method in a QoreClass
Definition: QoreClass.h:135
QoreObject
the implementation of Qore's object data type, reference counted, dynamically-allocated only
Definition: QoreObject.h:60
QoreObject::QoreObject
DLLLOCAL QoreObject(const QoreClass *oc, QoreProgram *p, QoreHashNode *d)
creates the object with the initial data passed as "d", used by the copy constructor
QoreObject::derefImpl
virtual DLLEXPORT bool derefImpl(ExceptionSink *xsink)
runs the destructor if necessary and dereferences all members
QoreObject::getReferencedPrivateData
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,...
QoreObject::getAsString
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...
QoreObject::hasMemberNotification
DLLLOCAL bool hasMemberNotification() const
returns true if the class has a memberNotification method
QoreObject::getClass
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 ...
QoreObject::getSurfaceClassName
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...
QoreObject::getReferencedPrivateData
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:280
QoreObject::tRef
DLLEXPORT void tRef() const
increments the existence reference count
QoreObject::QoreObject
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 ...
QoreObject::objectRefSelf
DLLLOCAL QoreObject * objectRefSelf() const
Returns the object with the reference count increased.
Definition: QoreObject.h:546
QoreObject::evalBuiltinMethodWithPrivateData
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
QoreObject::compareSoft
DLLEXPORT bool compareSoft(const QoreObject *obj, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) with possible type conversion of c...
QoreObject::customRef
virtual DLLLOCAL void customRef() const
custom reference handler
QoreObject::evalMember
DLLEXPORT QoreValue evalMember(const QoreString *member, ExceptionSink *xsink)
returns the value of the member with an incremented reference count, or executes the memberGate() met...
QoreObject::customDeref
virtual DLLLOCAL void customDeref(ExceptionSink *xsink)
custom dereference handler - with delete
QoreObject::tDeref
DLLEXPORT void tDeref()
decrements the existence reference count, when it reaches 0 the C++ object ("this") will be deleted
QoreObject::getAsString
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...
QoreObject::evalMethod
DLLEXPORT QoreValue evalMethod(const QoreString *name, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the arguments passed and returns the return value,...
QoreObject::isValid
DLLEXPORT bool isValid() const
returns true if the object is valid
QoreObject::isSystemObject
DLLEXPORT bool isSystemObject() const
returns true if the object is a system object (created with the system constructor)
QoreObject::removeMember
DLLEXPORT void removeMember(const QoreString *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors; the value is only dereferenc...
QoreObject::realDeref
DLLEXPORT void realDeref(ExceptionSink *xsink)
decrements the standard reference count of the object for references that cannot be part of a recursi...
QoreObject::removeMember
DLLEXPORT void removeMember(const char *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors; the value is only dereferenc...
QoreObject::compareHard
DLLEXPORT bool compareHard(const QoreObject *obj, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) with possible type conversion of c...
QoreObject::size
DLLEXPORT int size(ExceptionSink *xsink) const
returns the number of members of the object
QoreObject::~QoreObject
virtual DLLLOCAL ~QoreObject()
destructor
QoreObject::deleteMemberValue
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...
QoreObject::evalStaticMethod
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
QoreObject::getReferencedMemberNoMethod
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...
QoreObject::defaultSystemDestructor
DLLLOCAL void defaultSystemDestructor(qore_classid_t classID, ExceptionSink *xsink)
runs the destructor for system objects
QoreObject::getClass
DLLEXPORT const QoreClass * getClass() const
returns a pointer to the QoreClass of this object
QoreObject::setValue
DLLEXPORT void setValue(const char *key, QoreValue val, ExceptionSink *xsink)
sets the value of the given member to the given value
QoreObject::getStaticTypeName
static DLLLOCAL const char * getStaticTypeName()
returns the type name (useful in templates)
Definition: QoreObject.h:130
QoreObject::getStaticTypeCode
static DLLLOCAL qore_type_t getStaticTypeCode()
returns the type code (useful in templates)
Definition: QoreObject.h:135
QoreObject::addPrivateDataToString
DLLLOCAL void addPrivateDataToString(QoreString *str, ExceptionSink *xsink) const
concatenates info about private data to a string
QoreObject::execMemberNotification
DLLLOCAL void execMemberNotification(const char *member, ExceptionSink *xsink)
executes the member notification on the object the given member
QoreObject::getMemberValueNoMethod
DLLEXPORT QoreValue getMemberValueNoMethod(const QoreString *key, AutoVLock *vl, ExceptionSink *xsink) const
returns the pointer to the value of the member
QoreObject::evalStaticMethodVariant
static DLLEXPORT QoreValue evalStaticMethodVariant(const QoreMethod &method, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a static method variant
QoreObject::validInstanceOf
DLLEXPORT bool validInstanceOf(const QoreClass &qc) const
returns true if this object is a valid instance of the classid passed
QoreObject::deleteMemberValue
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...
QoreObject::takeMember
DLLEXPORT QoreValue takeMember(const char *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors and returns the value removed...
QoreObject::evalMethodVariant
DLLEXPORT QoreValue evalMethodVariant(const QoreMethod &method, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a normal object method variant
QoreObject::evalCopyMethodWithPrivateData
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...
QoreObject::obliterate
DLLLOCAL void obliterate(ExceptionSink *xsink)
destroys all members and dereferences all private data structures
QoreObject::doDelete
DLLEXPORT void doDelete(ExceptionSink *xsink)
runs the destructor on the object (if it hasn't already been deleted)
QoreObject::getReferencedMemberNoMethod
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...
QoreObject::evalMember
DLLEXPORT QoreValue evalMember(const char *member, ExceptionSink *xsink)
returns the value of the member with an incremented reference count, or executes the memberGate() met...
QoreObject::getAndClearPrivateData
DLLLOCAL AbstractPrivateData * getAndClearPrivateData(qore_classid_t key, ExceptionSink *xsink)
retrieves the private data pointer and clears it from the object's private data store,...
QoreObject::validInstanceOf
DLLEXPORT bool validInstanceOf(qore_classid_t cid) const
returns true if this object is a valid instance of the classid passed
QoreObject::externalDelete
DLLEXPORT void externalDelete(qore_classid_t key, ExceptionSink *xsink)
call this function when an object's private data is deleted externally
QoreObject::evalStaticMethod
static DLLEXPORT QoreValue evalStaticMethod(const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
executes a static method
QoreObject::getMemberValueNoMethod
DLLEXPORT QoreValue getMemberValueNoMethod(const char *key, AutoVLock *vl, ExceptionSink *xsink) const
returns the pointer to the value of the member
QoreObject::getClassAccess
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...
QoreObject::tryGetReferencedPrivateData
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:303
QoreObject::getTypeName
virtual DLLEXPORT const char * getTypeName() const
returns the type name as a c string
QoreObject::getMemberList
DLLEXPORT QoreListNode * getMemberList(ExceptionSink *xsink) const
returns the list of members, caller owns the list returned
QoreObject::setPrivate
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...
QoreObject::evalMethodVariant
DLLEXPORT QoreValue evalMethodVariant(const QoreMethod &method, const QoreClass *class_ctx, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
executes a normal object method variant
QoreObject::is_equal_hard
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...
QoreObject::getProgram
DLLEXPORT QoreProgram * getProgram() const
returns the QoreProgram object associated with this object
QoreObject::copyData
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...
QoreObject::evalMethod
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...
QoreObject::validInstanceOfStrict
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...
QoreObject::getMemberAsBigInt
DLLEXPORT int64 getMemberAsBigInt(const char *mem, bool &found, ExceptionSink *xsink) const
returns the value of the given member as an int64
QoreObject::evalMethod
DLLEXPORT QoreValue evalMethod(const char *name, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the arguments passed and returns the return value,...
QoreObject::tryGetReferencedPrivateData
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 ...
QoreObject::evalStaticMethodVariant
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
QoreObject::evalMethod
DLLEXPORT QoreValue evalMethod(const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
evaluates the given method with the arguments passed and returns the return value,...
QoreObject::takeMember
DLLEXPORT QoreValue takeMember(const QoreString *key, ExceptionSink *xsink)
removes a member from the object without explicitly calling destructors and returns the value removed...
QoreObject::getSurfaceClass
DLLEXPORT const QoreClass * getSurfaceClass() const
returns a pointer to the QoreClass of this object or to the injection target class in case the class ...
QoreObject::realCopy
virtual DLLEXPORT AbstractQoreNode * realCopy() const
performs a the same object with its reference count increased
QoreObject::realRef
DLLEXPORT void realRef()
increments the standard reference count of the object for references that cannot be part of a recursi...
QoreObject::QoreObject
DLLEXPORT QoreObject(const QoreClass *oc, QoreProgram *p)
creates an object as belonging to the given class, the QoreProgram object is referenced for the life ...
QoreObject::is_equal_soft
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...
QoreObject::getClassName
DLLEXPORT const char * getClassName() const
returns the name of the class
QoreObject::setMemberValue
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
QoreObject::hasMember
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)
QoreObject::evalImpl
virtual DLLLOCAL QoreValue evalImpl(bool &needs_deref, ExceptionSink *xsink) const
should never be called, does nothing
QoreObject::getAsBoolImpl
virtual DLLEXPORT bool getAsBoolImpl() const
returns false unless perl-boolean-evaluation is enabled, in which case it returns false only when emp...
QoreObject::getClass
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
QoreObjectWeakRefHolder
Convenience class for holding temporary / weak references to objects.
Definition: QoreObject.h:644
QoreProgram
supports parsing and executing Qore-language code, reference counted, dynamically-allocated only
Definition: QoreProgram.h:127
QoreString
Qore's string type supported by the QoreEncoding class.
Definition: QoreString.h:93
ReferenceHolder
a templated class to manage a reference count of an object that can throw a Qore-language exception w...
Definition: ReferenceHolder.h:52
TryPrivateDataRefHolder
convenience class for holding AbstractPrivateData references
Definition: QoreObject.h:728
TryPrivateDataRefHolder::operator=
DLLLOCAL void operator=(T *nv)
assigns a new pointer to the holder, dereferences the current pointer if any
Definition: QoreObject.h:734
qore_type_t
int16_t qore_type_t
used to identify unique Qore data and parse types (descendents of AbstractQoreNode)
Definition: common.h:70
qore_classid_t
unsigned qore_classid_t
used for the unique class ID for QoreClass objects
Definition: common.h:79
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
NT_OBJECT
const qore_type_t NT_OBJECT
type value for QoreObject
Definition: node_types.h:52
QoreValue
The main value class in Qore, designed to be passed by value.
Definition: QoreValue.h:276