JUCE  v5.1.1-3-g1a0b28c73
JUCE API
DynamicObject Class Reference

Represents a dynamically implemented object. More...

#include <juce_DynamicObject.h>

Inheritance diagram for DynamicObject:
Collaboration diagram for DynamicObject:

Public Types

typedef ReferenceCountedObjectPtr< DynamicObjectPtr
 

Public Member Functions

 DynamicObject ()
 
 DynamicObject (const DynamicObject &)
 
 ~DynamicObject ()
 
void clear ()
 Removes all properties and methods from the object. More...
 
virtual Ptr clone ()
 Returns a clone of this object. More...
 
void cloneAllProperties ()
 Calls var::clone() on all the properties that this object contains. More...
 
void decReferenceCount () noexcept
 Decreases the object's reference count. More...
 
bool decReferenceCountWithoutDeleting () noexcept
 Decreases the object's reference count. More...
 
NamedValueSetgetProperties () noexcept
 Returns the NamedValueSet that holds the object's properties. More...
 
virtual const vargetProperty (const Identifier &propertyName) const
 Returns a named property. More...
 
int getReferenceCount () const noexcept
 Returns the object's current reference count. More...
 
virtual bool hasMethod (const Identifier &methodName) const
 Checks whether this object has the specified method. More...
 
virtual bool hasProperty (const Identifier &propertyName) const
 Returns true if the object has a property with this name. More...
 
void incReferenceCount () noexcept
 Increments the object's reference count. More...
 
virtual var invokeMethod (Identifier methodName, const var::NativeFunctionArgs &args)
 Invokes a named method on this object. More...
 
virtual void removeProperty (const Identifier &propertyName)
 Removes a named property. More...
 
void setMethod (Identifier methodName, var::NativeFunction function)
 Adds a method to the class. More...
 
virtual void setProperty (const Identifier &propertyName, const var &newValue)
 Sets a named property. More...
 
virtual void writeAsJSON (OutputStream &, int indentLevel, bool allOnOneLine)
 Writes this object to a text stream in JSON format. More...
 

Protected Member Functions

void resetReferenceCount () noexcept
 Resets the reference count to zero without deleting the object. More...
 

Private Attributes

NamedValueSet properties
 

Detailed Description

Represents a dynamically implemented object.

This class is primarily intended for wrapping scripting language objects, but could be used for other purposes.

An instance of a DynamicObject can be used to store named properties, and by subclassing hasMethod() and invokeMethod(), you can give your object methods.

Member Typedef Documentation

◆ Ptr

Constructor & Destructor Documentation

◆ DynamicObject() [1/2]

DynamicObject::DynamicObject ( )

◆ DynamicObject() [2/2]

DynamicObject::DynamicObject ( const DynamicObject )

◆ ~DynamicObject()

DynamicObject::~DynamicObject ( )

Member Function Documentation

◆ clear()

void DynamicObject::clear ( )

Removes all properties and methods from the object.

◆ clone()

virtual Ptr DynamicObject::clone ( )
virtual

Returns a clone of this object.

The default implementation of this method just returns a new DynamicObject with a (deep) copy of all of its properties. Subclasses can override this to implement their own custom copy routines.

◆ cloneAllProperties()

void DynamicObject::cloneAllProperties ( )

Calls var::clone() on all the properties that this object contains.

◆ decReferenceCount()

void ReferenceCountedObject::decReferenceCount ( )
inlinenoexceptinherited

Decreases the object's reference count.

If the count gets to zero, the object will be deleted.

References jassert.

◆ decReferenceCountWithoutDeleting()

bool ReferenceCountedObject::decReferenceCountWithoutDeleting ( )
inlinenoexceptinherited

Decreases the object's reference count.

If the count gets to zero, the object will not be deleted, but this method will return true, allowing the caller to take care of deletion.

References jassert.

◆ getProperties()

NamedValueSet& DynamicObject::getProperties ( )
inlinenoexcept

Returns the NamedValueSet that holds the object's properties.

◆ getProperty()

virtual const var& DynamicObject::getProperty ( const Identifier propertyName) const
virtual

Returns a named property.

This returns var() if no such property exists.

◆ getReferenceCount()

int ReferenceCountedObject::getReferenceCount ( ) const
inlinenoexceptinherited

Returns the object's current reference count.

◆ hasMethod()

virtual bool DynamicObject::hasMethod ( const Identifier methodName) const
virtual

Checks whether this object has the specified method.

The default implementation of this just checks whether there's a property with this name that's actually a method, but this can be overridden for building objects with dynamic invocation.

◆ hasProperty()

virtual bool DynamicObject::hasProperty ( const Identifier propertyName) const
virtual

Returns true if the object has a property with this name.

Note that if the property is actually a method, this will return false.

◆ incReferenceCount()

void ReferenceCountedObject::incReferenceCount ( )
inlinenoexceptinherited

Increments the object's reference count.

This is done automatically by the smart pointer, but is public just in case it's needed for nefarious purposes.

◆ invokeMethod()

virtual var DynamicObject::invokeMethod ( Identifier  methodName,
const var::NativeFunctionArgs args 
)
virtual

Invokes a named method on this object.

The default implementation looks up the named property, and if it's a method call, then it invokes it.

This method is virtual to allow more dynamic invocation to used for objects where the methods may not already be set as properies.

◆ removeProperty()

virtual void DynamicObject::removeProperty ( const Identifier propertyName)
virtual

Removes a named property.

◆ resetReferenceCount()

void ReferenceCountedObject::resetReferenceCount ( )
inlineprotectednoexceptinherited

Resets the reference count to zero without deleting the object.

You should probably never need to use this!

◆ setMethod()

void DynamicObject::setMethod ( Identifier  methodName,
var::NativeFunction  function 
)

Adds a method to the class.

This is basically the same as calling setProperty (methodName, (var::NativeFunction) myFunction), but helps to avoid accidentally invoking the wrong type of var constructor. It also makes the code easier to read,

◆ setProperty()

virtual void DynamicObject::setProperty ( const Identifier propertyName,
const var newValue 
)
virtual

Sets a named property.

◆ writeAsJSON()

virtual void DynamicObject::writeAsJSON ( OutputStream ,
int  indentLevel,
bool  allOnOneLine 
)
virtual

Writes this object to a text stream in JSON format.

This method is used by JSON::toString and JSON::writeToStream, and you should never need to call it directly, but it's virtual so that custom object types can stringify themselves appropriately.

Member Data Documentation

◆ properties

NamedValueSet DynamicObject::properties
private

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