AngelScript
asIScriptObject Class Referenceabstract

The interface for an instance of a script object.

Public Member Functions

Memory management
virtual int AddRef () const =0
 Increase reference counter. More...
 
virtual int Release () const =0
 Decrease reference counter. More...
 
virtual asILockableSharedBoolGetWeakRefFlag () const =0
 Returns the weak ref flag for the object. More...
 
Type info
virtual int GetTypeId () const =0
 Returns the type id of the object. More...
 
virtual asIObjectTypeGetObjectType () const =0
 Returns the object type interface for the object. More...
 
Properties
virtual asUINT GetPropertyCount () const =0
 Returns the number of properties that the object contains. More...
 
virtual int GetPropertyTypeId (asUINT prop) const =0
 Returns the type id of the property referenced by prop. More...
 
virtual const char * GetPropertyName (asUINT prop) const =0
 Returns the name of the property referenced by prop. More...
 
virtual void * GetAddressOfProperty (asUINT prop)=0
 Returns a pointer to the property referenced by prop. More...
 
Miscellaneous
virtual asIScriptEngineGetEngine () const =0
 Return the script engine. More...
 
virtual int CopyFrom (asIScriptObject *other)=0
 Copies the content from another object of the same type. More...
 
User data
virtual void * SetUserData (void *data, asPWORD type=0)=0
 Sets user data on the script object instance. More...
 
virtual void * GetUserData (asPWORD type=0) const =0
 Gets user data from the script object instance. More...
 

Member Function Documentation

virtual int asIScriptObject::AddRef ( ) const
pure virtual
Returns
The number of references to this object.

Call this method when storing an additional reference to the object.

virtual int asIScriptObject::CopyFrom ( asIScriptObject other)
pure virtual
Parameters
[in]otherA pointer to the source object.
Returns
A negative value on error.
Return values
asINVALID_ARGThe argument is null.
asINVALID_TYPEThe other object is of different type.

This method copies the contents of the other object to this one.

virtual void* asIScriptObject::GetAddressOfProperty ( asUINT  prop)
pure virtual
Parameters
[in]propThe property index.
Returns
A pointer to the property value.

The method returns a pointer to the memory location for the property. Use the type id for the property to determine the content of the pointer, and how to handle it.

virtual asIScriptEngine* asIScriptObject::GetEngine ( ) const
pure virtual
Returns
The script engine.
virtual asIObjectType* asIScriptObject::GetObjectType ( ) const
pure virtual
Returns
The object type interface of the script object.

This does not increase the reference count of the returned object type.

virtual asUINT asIScriptObject::GetPropertyCount ( ) const
pure virtual
Returns
The number of member properties of the script object.
virtual const char* asIScriptObject::GetPropertyName ( asUINT  prop) const
pure virtual
Parameters
[in]propThe property index.
Returns
A null terminated string with the property name.
virtual int asIScriptObject::GetPropertyTypeId ( asUINT  prop) const
pure virtual
Parameters
[in]propThe property index.
Returns
The type id of the member property, or a negative value on error.
Return values
asINVALID_ARGprop is too large
virtual int asIScriptObject::GetTypeId ( ) const
pure virtual
Returns
The type id of the script object.
virtual void* asIScriptObject::GetUserData ( asPWORD  type = 0) const
pure virtual
Parameters
[in]typeAn identifier used to identify which user data to get.
Returns
The pointer to the user data.
virtual asILockableSharedBool* asIScriptObject::GetWeakRefFlag ( ) const
pure virtual
Returns
The weak ref flag for the object.

This is a short-cut for the asIScriptEngine::GetWeakRefFlagOfScriptObject method.

virtual int asIScriptObject::Release ( ) const
pure virtual
Returns
The number of references to this object.

Call this method when you will no longer use the references that you own.

virtual void* asIScriptObject::SetUserData ( void *  data,
asPWORD  type = 0 
)
pure virtual
Parameters
[in]dataA pointer to the user data.
[in]typeAn identifier used to identify which user data to set.
Returns
The previous pointer stored in the object type.

This method allows the application to associate a value, e.g. a pointer, with the script object instance. Multiple different values can be defined where the type argument identifies which is referred to.

The user data types identifiers between 1000 and 1999 are reserved for use by official add-ons.

Optionally, a callback function can be registered to clean up the user data when the script object is destroyed.


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