All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
QoreObject Class Reference

the implementation of Qore's object data type, reference counted, dynamically-allocated only More...

`#include <QoreObject.h>`

Inheritance diagram for QoreObject:
[legend]
Collaboration diagram for QoreObject:
[legend]

## Public Member Functions

DLLEXPORT | QoreObject (const QoreClass *oc, QoreProgram *p)
| creates an object as belonging to the given class, the QoreProgram object is referenced for the life of the object as well More...
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 of the object as well, and the private data is stored with the class ID of the class More...
DLLLOCAL | QoreObject (const QoreClass *oc, QoreProgram *p, QoreHashNode *d)
| creates the object with the initial data passed as "d", used by the copy constructor
DLLLOCAL void | addPrivateDataToString (QoreString *str, ExceptionSink *xsink) const
| concatenates info about private data to a string More...
DLLEXPORT int64 | bigIntEvalMethod (const char *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as an int64 More...
DLLEXPORT int64 | bigIntEvalMethod (const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as an int64 More...
DLLEXPORT bool | boolEvalMethod (const char *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as a bool More...
DLLEXPORT bool | boolEvalMethod (const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as a bool More...
DLLEXPORT bool | compareHard (const QoreObject *obj, ExceptionSink *xsink) const
| tests for equality ("deep compare" including all contained values) with possible type conversion of contained elements (hard compare) More...
DLLEXPORT bool | compareSoft (const QoreObject *obj, ExceptionSink *xsink) const
| tests for equality ("deep compare" including all contained values) with possible type conversion of contained elements (soft compare) More...
DLLEXPORT QoreHashNode * | copyData (ExceptionSink *xsink) const
| retuns all member data of the object (or 0 if there's an exception), caller owns the QoreHashNode reference returned More...
DLLLOCAL void | defaultSystemDestructor (qore_classid_t classID, ExceptionSink *xsink)
| runs the destructor for system objects More...
DLLEXPORT void | deleteBlockerRef () const
| increment the reference count of the object, to be called only from within a delete blocker More...
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 (destructor is called) More...
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 (destructor is called) More...
DLLEXPORT void | doDelete (ExceptionSink *xsink)
| runs the destructor on the object (if it hasn't already been deleted) More...
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 More...
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" (new copy)
DLLLOCAL bool | evalDeleteBlocker (qore_classid_t classid_for_method, BuiltinDeleteBlocker *meth)
| evaluates the delete blocker function for the managed private data
DLLLOCAL QoreValue | evalMember (const QoreString *member, ExceptionSink *xsink)
| returns the value of the member with an incremented reference count, or executes the memberGate() method and returns the value More...
DLLEXPORT AbstractQoreNode * | evalMethod (const QoreString *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned More...
DLLEXPORT AbstractQoreNode * | evalMethod (const char *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned More...
DLLEXPORT AbstractQoreNode * | evalMethod (const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned More...
DLLEXPORT QoreValue | evalMethodValue (const QoreString *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned More...
DLLEXPORT QoreValue | evalMethodValue (const char *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned More...
DLLEXPORT QoreValue | evalMethodValue (const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned More...
DLLEXPORT AbstractQoreNode * | evalMethodVariant (const QoreMethod &method, const QoreExternalMethodVariant *variant, const QoreListNode *args, ExceptionSink *xsink)
| executes a normal object method variant
DLLLOCAL void | execMemberNotification (const char *member, ExceptionSink *xsink)
| executes the member notification on the object the given member
DLLEXPORT void | externalDelete (qore_classid_t key, ExceptionSink *xsink)
| call this function when an object's private data is deleted externally More...
DLLEXPORT double | floatEvalMethod (const char *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as a double More...
DLLEXPORT double | floatEvalMethod (const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as a float More...
DLLLOCAL AbstractPrivateData * | getAndClearPrivateData (qore_classid_t key, ExceptionSink *xsink)
| retrieves the private data pointer and clears it from the object's private data store, used when executing destructors More...
virtual DLLEXPORT bool | getAsBoolImpl () const
| returns false unless perl-boolean-evaluation is enabled, in which case it returns false only when empty More...
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 existing QoreString More...
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 values) More...
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 More...
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 hierarchy and sets a flag indicating if it's privately inherited or not More...
DLLEXPORT const QoreClass * | getClass () const
| returns a pointer to the QoreClass of this object More...
DLLEXPORT const char * | getClassName () const
| returns the name of the class More...
DLLLOCAL AbstractQoreNode ** | getExistingValuePtr (const QoreString *mem, AutoVLock *vl, ExceptionSink *xsink) const
| returns a pointer to a pointer to the value of the member only if it already exists, so it can be set externally More...
DLLLOCAL AbstractQoreNode ** | getExistingValuePtr (const char *mem, AutoVLock *vl, ExceptionSink *xsink) const
| returns a pointer to a pointer to the value of the member only if it already exists More...
DLLEXPORT int64 | getMemberAsBigInt (const char *mem, bool &found, ExceptionSink *xsink) const
| returns the value of the given member as an int64 More...
DLLEXPORT QoreListNode * | getMemberList (ExceptionSink *xsink) const
| returns the list of members, caller owns the list returned More...
DLLEXPORT AbstractQoreNode * | getMemberValueNoMethod (const QoreString *key, AutoVLock *vl, ExceptionSink *xsink) const
| returns the pointer to the value of the member More...
DLLEXPORT AbstractQoreNode * | getMemberValueNoMethod (const char *key, AutoVLock *vl, ExceptionSink *xsink) const
| returns the pointer to the value of the member More...
DLLLOCAL AbstractQoreNode ** | getMemberValuePtrForInitialization (const char *member)
| returns a pointer to an object member during initialization (no locking; interal use only)
DLLEXPORT QoreProgram * | getProgram () const
| returns the QoreProgram object associated with this object More...
DLLEXPORT AbstractQoreNode * | getReferencedMemberNoMethod (const char *mem, ExceptionSink *xsink) const
| returns the value of the given member with the reference count incremented, the caller owns the AbstractQoreNode (reference) returned More...
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, caller owns the reference More...
DLLLOCAL QoreHashNode * | getRuntimeMemberHash (ExceptionSink *xsink) const
| retuns member data of the object (or 0 if there's an exception), private members are excluded if called outside the class, caller owns the QoreHashNode reference returned More...
virtual DLLEXPORT const char * | getTypeName () const
| returns the type name as a c string
DLLLOCAL bool | hasMemberNotification () const
| returns true if the class has a memberNotification method
DLLEXPORT int | intEvalMethod (const char *name, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as an int More...
DLLEXPORT int | intEvalMethod (const QoreMethod &method, const QoreListNode *args, ExceptionSink *xsink)
| evaluates the given method with the arguments passed and returns the return value as an int More...
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 compare) More...
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 (soft compare) More...
DLLEXPORT bool | isSystemObject () const
| returns true if the object is a system object (created with the system constructor) More...
DLLEXPORT bool | isValid () const
| returns true if the object is valid More...
DLLEXPORT void | mergeDataToHash (QoreHashNode *hash, ExceptionSink *xsink)
| copies all member data of the current object to the passed QoreHashNode More...
DLLLOCAL void | obliterate (ExceptionSink *xsink)
| destroys all members and dereferences all private data structures More...
virtual DLLEXPORT AbstractQoreNode * | realCopy () const
| performs a deep copy of the list and returns the new list
DLLEXPORT void | removeMember (const QoreString *key, ExceptionSink *xsink)
| removes a member from the object without explicitly calling destructors; the value is only dereferenced More...
DLLEXPORT void | removeMember (const char *key, ExceptionSink *xsink)
| removes a member from the object without explicitly calling destructors; the value is only dereferenced More...
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 constructors More...
DLLEXPORT void | setValue (const char *key, AbstractQoreNode *val, ExceptionSink *xsink)
| sets the value of the given member to the given value More...
DLLEXPORT int | size (ExceptionSink *xsink) const
| returns the number of members of the object More...
DLLEXPORT AbstractQoreNode * | takeMember (const QoreString *key, ExceptionSink *xsink)
| removes a member from the object without explicitly calling destructors and returns the value removed; the caller owns the reference returned More...
DLLEXPORT AbstractQoreNode * | takeMember (const char *key, ExceptionSink *xsink)
| removes a member from the object without explicitly calling destructors and returns the value removed; the caller owns the reference returned More...
DLLEXPORT void | tDeref ()
| decrements the existence reference count, when it reaches 0 the C++ object ("this") will be deleted More...
DLLEXPORT void | tRef () const
| increments the existence reference count More...
DLLEXPORT bool | validInstanceOf (qore_classid_t cid) const
| returns true if this object is a valid instance of the classid passed More...
DLLEXPORT bool | validInstanceOf (const QoreClass &qc) const
| returns true if this object is a valid instance of the classid passed More...
Public Member Functions inherited from AbstractQoreNode
DLLEXPORT | AbstractQoreNode (qore_type_t t, bool n_value, bool n_needs_eval, bool n_there_can_be_only_one=false, bool n_custom_reference_handlers=false)
| constructor takes the type More...
DLLEXPORT | AbstractQoreNode (const AbstractQoreNode &v)
| copy constructor
DLLEXPORT int64 | bigIntEval (ExceptionSink *xsink) const
| evaluates the object and returns a 64-bit integer value More...
DLLEXPORT bool | boolEval (ExceptionSink *xsink) const
| evaluates the object and returns a boolean value More...
DLLEXPORT void | deref (ExceptionSink *xsink)
| decrements the reference count and calls derefImpl() if there_can_be_only_one is false, otherwise does nothing More...
DLLEXPORT AbstractQoreNode * | eval (ExceptionSink *xsink) const
| evaluates the object and returns a value (or 0) More...
DLLEXPORT AbstractQoreNode * | eval (bool &needs_deref, ExceptionSink *xsink) const
| optionally evaluates the argument More...
DLLEXPORT double | floatEval (ExceptionSink *xsink) const
| evaluates the object and returns a floating-point value More...
DLLEXPORT int64 | getAsBigInt () const
| returns the 64-bit integer value of the object More...
DLLEXPORT bool | getAsBool () const
| returns the boolean value of the object More...
DLLEXPORT double | getAsFloat () const
| returns the float value of the object More...
DLLEXPORT int | getAsInt () const
| returns the integer value of the object More...
virtual DLLEXPORT class DateTime * | getDateTimeRepresentation (bool &del) const
| returns the DateTime representation of this type (default implementation: returns ZeroDate, del = false) More...
virtual DLLEXPORT void | getDateTimeRepresentation (DateTime &dt) const
| assigns the date representation of a value to the DateTime reference passed, default implementation does nothing More...
virtual DLLEXPORT QoreString * | getStringRepresentation (bool &del) const
| returns the value of the type converted to a string, default implementation: returns the empty string More...
virtual DLLEXPORT void | getStringRepresentation (QoreString &str) const
| concatentates the value of the type to an existing QoreString reference, default implementation does nothing More...
DLLLOCAL qore_type_t | getType () const
| returns the data type More...
DLLLOCAL bool | hasValueApi () const
| returns the "has value api" flags - FIXME: remove with new ABI
DLLEXPORT int | integerEval (ExceptionSink *xsink) const
| evaluates the object and returns an integer value More...
DLLLOCAL bool | is_value () const
| returns true if the node represents a value More...
DLLLOCAL bool | isReferenceCounted () const
| returns true if the object is reference-counted
DLLLOCAL bool | needs_eval () const
| returns true if the object needs evaluation to return a value, false if not More...
virtual DLLEXPORT AbstractQoreNode * | parseInit (LocalVar *oflag, int pflag, int &lvids, const QoreTypeInfo *&typeInfo)
| for use by parse types to initialize them for execution during stage 1 parsing More...
DLLEXPORT void | ref () const
| increments the reference count
DLLEXPORT AbstractQoreNode * | refSelf () const
| returns "this" with an incremented reference count More...
Public Member Functions inherited from QoreReferenceCounter
DLLEXPORT | QoreReferenceCounter ()
| creates the reference counter object
DLLEXPORT | ~QoreReferenceCounter ()
| destroys the reference counter object
DLLLOCAL bool | is_unique () const
| returns true if the reference count is 1 More...
DLLLOCAL int | reference_count () const
| gets the reference count More...
DLLEXPORT bool | ROdereference () const
| atomically decrements the reference count More...
DLLEXPORT void | ROreference () const
| atomically increments the reference count

## Static Public Member Functions

static DLLLOCAL qore_type_t | getStaticTypeCode ()
| returns the type code (useful in templates)
static DLLLOCAL const char * | getStaticTypeName ()
| returns the type name (useful in templates)

## Protected Member Functions

virtual DLLLOCAL | ~QoreObject ()
| destructor
virtual DLLLOCAL int64 | bigIntEvalImpl (ExceptionSink *xsink) const
| should never be called, does nothing More...
virtual DLLLOCAL bool | boolEvalImpl (ExceptionSink *xsink) const
| should never be called, does nothing More...
virtual DLLLOCAL void | customDeref (ExceptionSink *xsink)
| custom dereference handler - with delete
virtual DLLLOCAL void | customRef () const
| custom reference handler
DLLLOCAL void | customRefIntern () const
| custom reference handler - unlocked
virtual DLLEXPORT bool | derefImpl (ExceptionSink *xsink)
| runs the destructor if necessary and dereferences all members More...
virtual DLLLOCAL AbstractQoreNode * | evalImpl (ExceptionSink *xsink) const
| should never be called, does nothing More...
virtual DLLLOCAL AbstractQoreNode * | evalImpl (bool &needs_deref, ExceptionSink *xsink) const
| should never be called, does nothing More...
virtual DLLLOCAL double | floatEvalImpl (ExceptionSink *xsink) const
| should never be called, does nothing More...
virtual DLLLOCAL int | integerEvalImpl (ExceptionSink *xsink) const
| should never be called, does nothing More...
Protected Member Functions inherited from AbstractQoreNode
virtual DLLEXPORT | ~AbstractQoreNode ()
| default destructor does nothing More...

## Additional Inherited Members

Protected Attributes inherited from AbstractQoreNode
bool | custom_reference_handlers: 1
| set to one for objects that need custom reference handlers
bool | has_value_api: 1
| set to flag with new QoreValue API (derived from ParseNode) - FIXME: to be removed when new ABI is implemented
bool | needs_eval_flag: 1
| if this is true then the type can be evaluated
bool | there_can_be_only_one: 1
| if this is set to true, then reference counting is turned off for objects of this class
qore_type_t | type: 11
| the type of the object More...
bool | value: 1
| this is true for values, if false then either the type needs evaluation to produce a value or is a parse expression
Protected Attributes inherited from QoreReferenceCounter
QoreThreadLock | mRO
| pthread lock to ensure atomicity of updates for architectures where we don't have an atomic increment and decrement implementation

## Detailed Description

the implementation of Qore's object data type, reference counted, dynamically-allocated only

objects in Qore are unique unless copied explicitly (similar to Java) Builtin classes (those classes implemented in C++ as opposed to user classes implemented in the Qore language) can have "private data", which is data that maintains the state of the object per that class. QoreObject objects store this data as well as any member data.

objects have two levels of reference counts - one is for the existence of the c++ object (tRefs below) the other is for the scope of the object (the parent QoreReferenceCounter) - when this reaches 0 the object will have its destructor run (if it hasn't already been deleted). Only when the tRef counter reaches 0, meaning that no more pointers are pointing to this object will the object actually be deleted.

See Also
  QoreClass

## Constructor & Destructor Documentation

DLLEXPORT QoreObject::QoreObject | ( | const QoreClass * | oc,
|  | QoreProgram * | p
| ) |  |

creates an object as belonging to the given class, the QoreProgram object is referenced for the life of the object as well

Parameters

  oc | the class of the object being created
  p | the QoreProgram object where the object "lives", this QoreProgram object is referenced for the life of the object to ensure that it is not deleted while the object still exists (for example, if the object is exported to a parent QoreProgram object)

DLLEXPORT QoreObject::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 of the object as well, and the private data is stored with the class ID of the class

Parameters

  oc | the class of the object being created
  p | the QoreProgram object where the object "lives", this QoreProgram object is referenced for the life of the object to ensure that it is not deleted while the object still exists (for example, if the object is exported to a parent QoreProgram object)
  data | the private data corresponding to the class ID of the class passed

## Member Function Documentation

DLLLOCAL void QoreObject::addPrivateDataToString | ( | QoreString * | str,
|  | ExceptionSink * | xsink
| ) |  | const

concatenates info about private data to a string

Parameters

  str | the string to concatenate to
  xsink | if an error occurs, the Qore-language exception information will be added here

virtual DLLLOCAL int64 QoreObject::bigIntEvalImpl | ( | ExceptionSink * | xsink | ) | const

protected virtual

should never be called, does nothing

in debugging builds calls to this function will abort

Reimplemented from AbstractQoreNode.

DLLEXPORT int64 QoreObject::bigIntEvalMethod | ( | const char * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as an int64

Parameters

  name | the name of the method to evaluate, must be in QCS_DEFAULT encoding
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT int64 QoreObject::bigIntEvalMethod | ( | const QoreMethod & | method,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as an int64

Parameters

  method | the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

virtual DLLLOCAL bool QoreObject::boolEvalImpl | ( | ExceptionSink * | xsink | ) | const

protected virtual

should never be called, does nothing

in debugging builds calls to this function will abort

Reimplemented from AbstractQoreNode.

DLLEXPORT bool QoreObject::boolEvalMethod | ( | const char * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as a bool

Parameters

  name | the name of the method to evaluate, must be in QCS_DEFAULT encoding
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT bool QoreObject::boolEvalMethod | ( | const QoreMethod & | method,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as a bool

Parameters

  method | the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT bool QoreObject::compareHard | ( | const QoreObject * | obj,
|  | ExceptionSink * | xsink
| ) |  | const

tests for equality ("deep compare" including all contained values) with possible type conversion of contained elements (hard compare)

Parameters

  obj | the object to compare
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT bool QoreObject::compareSoft | ( | const QoreObject * | obj,
|  | ExceptionSink * | xsink
| ) |  | const

tests for equality ("deep compare" including all contained values) with possible type conversion of contained elements (soft compare)

Parameters

  obj | the object to compare
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT QoreHashNode* QoreObject::copyData | ( | ExceptionSink * | xsink | ) | const

retuns all member data of the object (or 0 if there's an exception), caller owns the QoreHashNode reference returned

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

DLLLOCAL void QoreObject::defaultSystemDestructor | ( | qore_classid_t | classID,
|  | ExceptionSink * | xsink
| ) |  |

runs the destructor for system objects

Parameters

  classID | the ID of the class
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT void QoreObject::deleteBlockerRef | ( |  | ) | const

increment the reference count of the object, to be called only from within a delete blocker

it is an error to call this function from anything other than a delete blocker

DLLEXPORT void QoreObject::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 (destructor is called)

Parameters

  key | the name of the member to delete
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT void QoreObject::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 (destructor is called)

Parameters

  key | the name of the member to delete, assumed to be in the default encoding (QCS_DEFAULT)
  xsink | if an error occurs, the Qore-language exception information will be added here

virtual DLLEXPORT bool QoreObject::derefImpl | ( | ExceptionSink * | xsink | ) |

protected virtual

runs the destructor if necessary and dereferences all members

Note that other objects could be deleted as well if they are members of this object, any exceptions thrown there will also be added to "xsink"

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

Reimplemented from AbstractQoreNode.

DLLEXPORT void QoreObject::doDelete | ( | ExceptionSink * | xsink | ) |

runs the destructor on the object (if it hasn't already been deleted)

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

DLLLOCAL QoreValue QoreObject::evalBuiltinMethodWithPrivateData | ( | const QoreMethod & | method,
|  | const BuiltinNormalMethodVariantBase * | meth,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

called to evaluate a builtin method when private data is available

Parameters

  method | a constant reference to the QoreMethod object
  meth | the name of the method to evalute
  args | the arguments for the method
  xsink | if an error occurs, the Qore-language exception information will be added here

virtual DLLLOCAL AbstractQoreNode* QoreObject::evalImpl | ( | ExceptionSink * | xsink | ) | const

protected virtual

should never be called, does nothing

in debugging builds calls to this function will abort

Implements AbstractQoreNode.

virtual DLLLOCAL AbstractQoreNode* QoreObject::evalImpl | ( | bool & | needs_deref,
|  | ExceptionSink * | xsink
| ) |  | const

protected virtual

should never be called, does nothing

in debugging builds calls to this function will abort

Implements AbstractQoreNode.

DLLLOCAL QoreValue QoreObject::evalMember | ( | const QoreString * | member,
|  | ExceptionSink * | xsink
| ) |  |

returns the value of the member with an incremented reference count, or executes the memberGate() method and returns the value

Parameters

  member | the name of the member to get the value for (or evaluate the memberGate() method against)
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT AbstractQoreNode* QoreObject::evalMethod | ( | const QoreString * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned

Parameters

  name | the name of the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT AbstractQoreNode* QoreObject::evalMethod | ( | const char * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned

Parameters

  name | the name of the method to evaluate, must be in QCS_DEFAULT encoding
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT AbstractQoreNode* QoreObject::evalMethod | ( | const QoreMethod & | method,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned

Parameters

  method | the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT QoreValue QoreObject::evalMethodValue | ( | const QoreString * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned

Parameters

  name | the name of the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT QoreValue QoreObject::evalMethodValue | ( | const char * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned

Parameters

  name | the name of the method to evaluate, must be in QCS_DEFAULT encoding
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT QoreValue QoreObject::evalMethodValue | ( | const QoreMethod & | method,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value, caller owns the AbstractQoreNode (reference) returned

Parameters

  method | the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT void QoreObject::externalDelete | ( | qore_classid_t | key,
|  | ExceptionSink * | xsink
| ) |  |

call this function when an object's private data is deleted externally

this function will clear the private data and delete the object

Parameters

  key | the class ID of the class that owns the private data
  xsink | if an error occurs, the Qore-language exception information will be added here

virtual DLLLOCAL double QoreObject::floatEvalImpl | ( | ExceptionSink * | xsink | ) | const

protected virtual

should never be called, does nothing

in debugging builds calls to this function will abort

Reimplemented from AbstractQoreNode.

DLLEXPORT double QoreObject::floatEvalMethod | ( | const char * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as a double

Parameters

  name | the name of the method to evaluate, must be in QCS_DEFAULT encoding
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT double QoreObject::floatEvalMethod | ( | const QoreMethod & | method,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as a float

Parameters

  method | the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLLOCAL AbstractPrivateData* QoreObject::getAndClearPrivateData | ( | qore_classid_t | key,
|  | ExceptionSink * | xsink
| ) |  |

retrieves the private data pointer and clears it from the object's private data store, used when executing destructors

Parameters

  key | the class key to use
  xsink | if an error occurs, the Qore-language exception information will be added here

virtual DLLEXPORT bool QoreObject::getAsBoolImpl | ( |  | ) | const

virtual

returns false unless perl-boolean-evaluation is enabled, in which case it returns false only when empty

Returns
  false unless perl-boolean-evaluation is enabled, in which case it returns false only when empty

Reimplemented from AbstractQoreNode.

virtual DLLEXPORT int QoreObject::getAsString | ( | QoreString & | str,
|  | int | foff,
|  | ExceptionSink * | xsink
| ) |  | const

virtual

concatenate the verbose string representation of the list (including all contained values) to an existing QoreString

used for n and N printf formatting

Parameters

  str | the string representation of the type will be concatenated to this QoreString reference
  foff | for multi-line formatting offset, -1 = no line breaks
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  -1 for exception raised, 0 = OK

Implements AbstractQoreNode.

virtual DLLEXPORT QoreString* QoreObject::getAsString | ( | bool & | del,
|  | int | foff,
|  | ExceptionSink * | xsink
| ) |  | const

virtual

returns a QoreString giving the verbose string representation of the List (including all contained values)

used for n and N printf formatting

Parameters

  del | if this is true when the function returns, then the returned QoreString pointer should be deleted, if false, then it must not be
  foff | for multi-line formatting offset, -1 = no line breaks
  xsink | if an error occurs, the Qore-language exception information will be added here NOTE: Use the QoreNodeAsStringHelper class (defined in QoreStringNode.h) instead of using this function directly

See Also
  QoreNodeAsStringHelper

Implements AbstractQoreNode.

DLLEXPORT const QoreClass* QoreObject::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

Parameters

  cid | the class ID passed

Returns
  a pointer to a QoreClass object if the class ID passed is a valid class in the hierarchy

DLLEXPORT const QoreClass* QoreObject::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 hierarchy and sets a flag indicating if it's privately inherited or not

if the class ID is equal to the current class or is a base class of the current class, the appropriate QoreClass pointer will be returned.

Parameters

  cid | the class ID of the QoreClass to find
  priv | a flag indicating if the class is privately inherited or not

Returns
  a pointer to the QoreClass object representing the class ID passed if it exists in the class hierarchy

DLLEXPORT const QoreClass* QoreObject::getClass | ( |  | ) | const

returns a pointer to the QoreClass of this object

Returns
  a pointer to the QoreClass of this object

DLLEXPORT const char* QoreObject::getClassName | ( |  | ) | const

returns the name of the class

Returns
  the name of the class

DLLLOCAL AbstractQoreNode** QoreObject::getExistingValuePtr | ( | const QoreString * | mem,
|  | AutoVLock * | vl,
|  | ExceptionSink * | xsink
| ) |  | const

returns a pointer to a pointer to the value of the member only if it already exists, so it can be set externally

if no exception occurs, the lock is held and added to the AutoVLock "vl", otherwise the lock is released an exception will be thrown if the character encoding conversion fails also if the object has a deleted status an exception will be thrown

Parameters

  mem | the name of the member
  vl | the AutoVLock container for nested locking
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  a pointer to the pointer for the value of the member or 0 if it didn't already exist

DLLLOCAL AbstractQoreNode** QoreObject::getExistingValuePtr | ( | const char * | mem,
|  | AutoVLock * | vl,
|  | ExceptionSink * | xsink
| ) |  | const

returns a pointer to a pointer to the value of the member only if it already exists

if no exception occurs, the lock is held and added to the AutoVLock "vl", otherwise the lock is released if the object has a deleted status an exception will be thrown

Parameters

  mem | the name of the member, assumed to be in the default encoding (QCS_DEFAULT)
  vl | the AutoVLock container for nested locking
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  a pointer to the pointer for the value of the member or 0 if it didn't already exist

DLLEXPORT int64 QoreObject::getMemberAsBigInt | ( | const char * | mem,
|  | bool & | found,
|  | ExceptionSink * | xsink
| ) |  | const

returns the value of the given member as an int64

Parameters

  mem | the name member to retrieve the value for
  found | returns true if the member was found, false if not
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  the value of the given member as an int64

DLLEXPORT QoreListNode* QoreObject::getMemberList | ( | ExceptionSink * | xsink | ) | const

returns the list of members, caller owns the list returned

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT AbstractQoreNode* QoreObject::getMemberValueNoMethod | ( | const QoreString * | key,
|  | AutoVLock * | vl,
|  | ExceptionSink * | xsink
| ) |  | const

returns the pointer to the value of the member

if the member exists, the lock is held and added to the AutoVLock "vl", otherwise the lock is released an exception will be thrown if the character encoding conversion fails also if the object has a deleted status an exception will be thrown NOTE: the value returned is not referenced by this function, but rather the object is locked

Parameters

  key | the name of the member
  vl | the AutoVLock container for nested locking
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT AbstractQoreNode* QoreObject::getMemberValueNoMethod | ( | const char * | key,
|  | AutoVLock * | vl,
|  | ExceptionSink * | xsink
| ) |  | const

returns the pointer to the value of the member

NOTE: the value returned is not referenced by this function, but rather the object is locked

Parameters

  key | the name of the member, assumed to be in the default encoding (QCS_DEFAULT)
  vl | the AutoVLock container for nested locking
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT QoreProgram* QoreObject::getProgram | ( |  | ) | const

returns the QoreProgram object associated with this object

for system objects only (created with the system constructor) this will be 0

Returns
  the QoreProgram object associated with this object

DLLEXPORT AbstractQoreNode* QoreObject::getReferencedMemberNoMethod | ( | const char * | mem,
|  | ExceptionSink * | xsink
| ) |  | const

returns the value of the given member with the reference count incremented, the caller owns the AbstractQoreNode (reference) returned

Parameters

  mem | the name member to retrieve the value for
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  the value of the given member with the reference count incremented, the caller owns the AbstractQoreNode (reference) returned

DLLEXPORT AbstractPrivateData* QoreObject::getReferencedPrivateData | ( | qore_classid_t | key,
|  | ExceptionSink * | xsink
| ) |  | const

returns the private data corresponding to the class ID passed with an incremented reference count, caller owns the reference

Parameters

  key | the class ID of the class to get the private data for
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLLOCAL QoreHashNode* QoreObject::getRuntimeMemberHash | ( | ExceptionSink * | xsink | ) | const

retuns member data of the object (or 0 if there's an exception), private members are excluded if called outside the class, caller owns the QoreHashNode reference returned

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  member data of the object

virtual DLLLOCAL int QoreObject::integerEvalImpl | ( | ExceptionSink * | xsink | ) | const

protected virtual

should never be called, does nothing

in debugging builds calls to this function will abort

Reimplemented from AbstractQoreNode.

DLLEXPORT int QoreObject::intEvalMethod | ( | const char * | name,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as an int

Parameters

  name | the name of the method to evaluate, must be in QCS_DEFAULT encoding
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

DLLEXPORT int QoreObject::intEvalMethod | ( | const QoreMethod & | method,
|  | const QoreListNode * | args,
|  | ExceptionSink * | xsink
| ) |  |

evaluates the given method with the arguments passed and returns the return value as an int

Parameters

  method | the method to evaluate
  args | the arguments for the method (may be 0)
  xsink | if an error occurs, the Qore-language exception information will be added here

Deprecated:
  use evalMethodValue() instead

virtual DLLEXPORT bool QoreObject::is_equal_hard | ( | const AbstractQoreNode * | v,
|  | ExceptionSink * | xsink
| ) |  | const

virtual

tests for equality ("deep compare" including all contained values) without type conversions (hard compare)

Parameters

  v | the value to compare
  xsink | if an error occurs, the Qore-language exception information will be added here

Implements AbstractQoreNode.

virtual DLLEXPORT bool QoreObject::is_equal_soft | ( | const AbstractQoreNode * | v,
|  | ExceptionSink * | xsink
| ) |  | const

virtual

tests for equality ("deep compare" including all contained values) with possible type conversion (soft compare)

Parameters

  v | the value to compare
  xsink | if an error occurs, the Qore-language exception information will be added here

Implements AbstractQoreNode.

DLLEXPORT bool QoreObject::isSystemObject | ( |  | ) | const

returns true if the object is a system object (created with the system constructor)

Returns
  true if the object is a system object (created with the system constructor)

DLLEXPORT bool QoreObject::isValid | ( |  | ) | const

returns true if the object is valid

Returns
  true if the object is valid

DLLEXPORT void QoreObject::mergeDataToHash | ( | QoreHashNode * | hash,
|  | ExceptionSink * | xsink
| ) |  |

copies all member data of the current object to the passed QoreHashNode

Parameters

  hash | the hash to copy all data from
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLLOCAL void QoreObject::obliterate | ( | ExceptionSink * | xsink | ) |

destroys all members and dereferences all private data structures

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT void QoreObject::removeMember | ( | const QoreString * | key,
|  | ExceptionSink * | xsink
| ) |  |

removes a member from the object without explicitly calling destructors; the value is only dereferenced

objects will be destructed if they go out of scope, however

Parameters

  key | the name of the member to remove
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT void QoreObject::removeMember | ( | const char * | key,
|  | ExceptionSink * | xsink
| ) |  |

removes a member from the object without explicitly calling destructors; the value is only dereferenced

objects will be destructed if they go out of scope, however

Parameters

  key | the name of the member to remove, assumed to be in the default encoding (QCS_DEFAULT)
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT void QoreObject::setPrivate | ( | qore_classid_t | key,
|  | AbstractPrivateData * | pd
| ) |  |

sets private data for the object against the class ID passed, used in C++ functions implementing Qore constructors

Parameters

  key | the class ID of the class to set the private data for
  pd | the private data for the given class ID

DLLEXPORT void QoreObject::setValue | ( | const char * | key,
|  | AbstractQoreNode * | val,
|  | ExceptionSink * | xsink
| ) |  |

sets the value of the given member to the given value

the value must be already referenced for the assignment to the object

Parameters

  key | the name of the member
  val | the value to set for the member (must be already referenced for the assignment, 0 is OK too)
  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT int QoreObject::size | ( | ExceptionSink * | xsink | ) | const

returns the number of members of the object

Parameters

  xsink | if an error occurs, the Qore-language exception information will be added here

DLLEXPORT AbstractQoreNode* QoreObject::takeMember | ( | const QoreString * | key,
|  | ExceptionSink * | xsink
| ) |  |

removes a member from the object without explicitly calling destructors and returns the value removed; the caller owns the reference returned

if a Qore-language exception is raised, the return value is always 0

Parameters

  key | the name of the member to remove
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  the value removed from the object; caller owns the reference

DLLEXPORT AbstractQoreNode* QoreObject::takeMember | ( | const char * | key,
|  | ExceptionSink * | xsink
| ) |  |

removes a member from the object without explicitly calling destructors and returns the value removed; the caller owns the reference returned

if a Qore-language exception is raised, the return value is always 0

Parameters

  key | the name of the member to remove, assumed to be in the default encoding (QCS_DEFAULT)
  xsink | if an error occurs, the Qore-language exception information will be added here

Returns
  the value removed from the object; caller owns the reference

DLLEXPORT void QoreObject::tDeref | ( |  | ) |

decrements the existence reference count, when it reaches 0 the C++ object ("this") will be deleted

To increment the existence reference count, call QoreObject::tRef()

See Also
  QoreObject::tRef()

DLLEXPORT void QoreObject::tRef | ( |  | ) | const

increments the existence reference count

Will not prolong the scope of the object (use QoreObject::ref() to prolong the scope of the object). To derecrement the count, call QoreObject::tDeref()

See Also
  QoreObject::tDeref()
  QoreObject::ref()

DLLEXPORT bool QoreObject::validInstanceOf | ( | qore_classid_t | cid | ) | const

returns true if this object is a valid instance of the classid passed

Parameters

  cid | the class ID to check

Deprecated:
  use validInstanceOf(const QoreClass&) instead

DLLEXPORT bool QoreObject::validInstanceOf | ( | const QoreClass & | qc | ) | const

returns true if this object is a valid instance of the classid passed

Parameters

  qc | the class to check

The documentation for this class was generated from the following file:

- include/qore/QoreObject.h (6de6cc3b438610bf03b2bec44a3d7c61f90e3165)