openDAQ
Open data acquisition platform
IterablePtr< TValueInterface, TValuePtr > Class Template Reference

An iterable object can construct iterators and use them to iterate through items. More...

+ Inheritance diagram for IterablePtr< TValueInterface, TValuePtr >:
+ Collaboration diagram for IterablePtr< TValueInterface, TValuePtr >:

Detailed Description

template<class TValueInterface, class TValuePtr>
class IterablePtr< TValueInterface, TValuePtr >

An iterable object can construct iterators and use them to iterate through items.

Use this object to get the start and end iterators. Use iterators to iterate through available items. Containers such as lists and dictionaries usually implement this interface.

Public Member Functions

NativeIterator< TValuePtr > createStartIteratorInterface () const
 Creates and returns the object's start iterator. More...
 
NativeIterator< TValuePtr > createEndIteratorInterface () const
 Creates and returns the object's end iterator. More...
 
NativeIterator< TValuePtr > begin () const
 Creates and returns the object's start iterator. More...
 
NativeIterator< TValuePtr > end () const
 Creates and returns the object's end iterator. More...
 
- Public Member Functions inherited from ObjectPtr< IIterable >
 ObjectPtr ()
 Creates a smart pointer with no wrapped interface.
 
 ObjectPtr (std::nullptr_t)
 Creates a smart pointer with no wrapped interface.
 
 ObjectPtr (const ObjectPtr< IIterable > &objPtr)
 Creates a smart pointer from another smart pointer. More...
 
 ObjectPtr (ObjectPtr< IIterable > &&objPtr) noexcept
 Creates a smart pointer from another smart pointer with move semantics. More...
 
 ObjectPtr (const ObjectPtr< U > &objPtr)
 Creates a smart pointer from another smart pointer of a different interface type. More...
 
 ObjectPtr (ObjectPtr< U > &&objPtr)
 Creates a smart pointer from another smart pointer of a different interface type with move semantics. More...
 
 ObjectPtr (IIterable *&obj)
 Creates a smart pointer from an interface pointer. More...
 
 ObjectPtr (IIterable *&&obj)
 Creates a smart pointer from an interface pointer with move semantics. More...
 
 ObjectPtr (IWeakRef *obj)
 Creates a smart pointer from a weak reference interface pointer. More...
 
 ObjectPtr (const wchar_t *value)
 Creates a string object smart pointer from UTF16 null terminated sequence. More...
 
 ObjectPtr (ConstCharPtr value)
 Creates a string object smart pointer from UTF8 null terminated sequence. More...
 
 ObjectPtr (const U &value)
 Creates a smart pointer wrapper from value type. More...
 
virtual ~ObjectPtr ()
 Destructor. More...
 
bool equals (ObjectPtr< IBaseObject > other) const
 Compares object to another object for equality. More...
 
IIterabledetach ()
 Disassociates this smart pointer object from the interface that it represents. More...
 
void dispose () const
 Disposes all references held by the object. More...
 
void release ()
 Resets the wrapped interface to nullptr. More...
 
IIterableaddRefAndReturn () const
 Increments the reference count and returns the interface. More...
 
 operator IIterable * () const
 Casts the pointer to the wrapped interface. More...
 
bool assigned () const
 Checks if the smart pointer is not empty.
 
IIterablegetObject () const
 Gets the pointer to the wrapped interface. More...
 
IIterable ** addressOf ()
 Gets the address of the pointer to the wrapped interface. More...
 
IIterable ** operator& ()
 Gets the address of the pointer to the wrapped interface. More...
 
U * as (bool borrow=false) const
 Casts the wrapped interface to another interface. More...
 
U * asOrNull (bool borrow=false) const
 Casts the wrapped interface to another interface. More...
 
Ptr asPtr (bool borrow=false) const
 Casts the wrapped interface to another interface and wraps in a smart pointer. More...
 
Ptr asPtrOrNull (bool borrow=false) const
 Casts the wrapped interface to another interface and wraps in a smart pointer. More...
 
bool supportsInterface () const
 Checks if the wrapped interface supports another interface. More...
 
bool supportsInterface (const IntfID &id) const
 Checks if the wrapped interface supports another interface using the interface ID. More...
 
CoreType getCoreType () const
 Gets the object's CoreType. More...
 
ObjectPtr< IBaseObjectconvertTo (CoreType ct) const
 Converts the object to the specified CoreType. More...
 
SizeT getHashCode () const
 Returns hash code of the object. More...
 
ObjectPtr< IStringtoString () const
 Converts the object to the string object. More...
 
void freeze () const
 Freezes the object. More...
 
Bool isFrozen () const
 Checks if the object is frozen. More...
 
void dispatch (const ObjectPtr< IBaseObject > &params) const
 Calls the stored callback. More...
 
void dispatch () const
 Calls the stored callback without any parameters. More...
 
void execute () const
 Calls the stored callback without any parameters. More...
 
void execute (Params... params) const
 Calls the stored callback. More...
 
ObjectPtr< IBaseObjectcall (Params... params) const
 Calls the stored callback and returns the result. More...
 
bool isBorrowed () const
 Checks if the reference is borrowed. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from ObjectPtr< IIterable >
static InterfaceToSmartPtr< U >::SmartPtr Borrow (IIterable *&obj)
 Borrows an interface. More...
 
static InterfaceToSmartPtr< V >::SmartPtr Borrow (U *&obj)
 Borrows an interface from the interface of another type. More...
 
static InterfaceToSmartPtr< U >::SmartPtr Adopt (IIterable *obj)
 Adopts an interface. More...
 
static Bool Equals (const ObjectPtr< IBaseObject > &a, const ObjectPtr< IBaseObject > &b)
 Value based comparison of two objects. If both objects are nullptr, they are considered to be equal. More...
 

Member Function Documentation

◆ begin()

NativeIterator< TValuePtr > begin

Creates and returns the object's start iterator.

Returns
The object's start iterator.

◆ createEndIteratorInterface()

NativeIterator< TValuePtr > createEndIteratorInterface

Creates and returns the object's end iterator.

Returns
The object's stop iterator.

◆ createStartIteratorInterface()

NativeIterator< TValuePtr > createStartIteratorInterface

Creates and returns the object's start iterator.

Returns
The object's start iterator.

◆ end()

NativeIterator< TValuePtr > end

Creates and returns the object's end iterator.

Returns
The object's stop iterator.