// Version: $Id: 6a03ea4152811c08c40a3689a9e9371d054b8fc4 $
//
//

// Commentary:
//
//

// Change Log:
//
//

// Code:

#include "dtkMetaContainerSequential.h"

// /////////////////////////////////////////////////////////////////
// dtkMetaContainerSequential::item implementation
// /////////////////////////////////////////////////////////////////

/*! \class dtkMetaContainerSequential::item
    \inmodule dtkMeta

    \brief The dtkMetaContainerSequential::item class enables to use
    arithmetic operations on the elements of a container in a
    QVariant.

    \snippet dtkmeta_container_sequential.cpp 5

    By default, the operators such as \c += , \c *= , \c -= , \c /= ,
    \c == or \c != are available for elements of integer and floating
    types. The += operator is also available for QString type. For any
    other types, these operators are disabled, a warning being then
    emitted.

    However, it is likely to enable all or a part of these operators
    by overloading the template struct \c
    dtkMetaContainerSequentialPrivate::itemOperator<I,T,false> where
    \c T is the type you want to deal with.

    Given a type \c Dummy that supports \c += and \c /= operators for
    instance. In order to enable these operators for an item that
    refers a \c Dummy element in a container, one must overload the
    template struct as follows:

    \code
    namespace dtkMetaContainerSequentialPrivate {
       template <typename I> struct itemOperator<I, Dummy, false> : itemOperatorBase<I, Dummy>
       {
           static void addValue(I& it, const Dummy *value) { *it += *value; }
           static void divValue(I& it, const Dummy *value) { *it /= *value; }
       };
    }
    \endcode

    Then, it is likely to use the items of the
    dtkMetaContainerSequential as if they were \c Dummy variable.

    \code
    QList<Dummy> my_list;
    my_list << Dummy() << Dummy() << Dummy();
    QVariant variant = QVariant::fromValue(&my_list);
    dtkMetaContainerSequential meta_list = variant.value<dtkMetaContainerSequential>();
    for (dtkMetaContainerSequential::item &item : meta_list) {
        item += Dummy();
        item /= Dummy();
    }
    \endcode

    \sa dtkMetaContainerSequential, dtkMetaContainerSequential::iterator
*/

// /////////////////////////////////////////////////////////////////
// dtkMetaContainerSequential::iterator implementation
// /////////////////////////////////////////////////////////////////

/*! \class dtkMetaContainerSequential::iterator
    \inmodule dtkMeta

    \brief The dtkMetaContainerSequential::iterator together with the
    dtkMetaContainerSequential::item enable to iterate over a container
    in a QVariant and to modify its content.

    As its const counterpart it can only be created by a
    dtkMetaContainerSequential instance, and can be used in a way
    similar to other stl-style iterators.

    Furthermore, it gives access to the element via a
    dtkMetaContainerSequential::item which provides functionalities to
    modify the element.

    \snippet dtkmeta_container_sequential.cpp 4

    \sa dtkMetaContainerSequential::item, dtkMetaContainerSequential
*/

/*! \fn explicit dtkMetaContainerSequential::iterator::iterator(HandlerIterator *iterator)
    \internal
*/

/*! \fn dtkMetaContainerSequential::iterator::iterator(const iterator& o)

    Creates a copy of \a o.
*/

/*! \fn dtkMetaContainerSequential::iterator::iterator(iterator&& o)

    Move constructor from iterator \a o.
*/

/*! \fn dtkMetaContainerSequential::iterator::~iterator(void)

    Detroys the iterator and the related dtkMetaContainerSequential::item.
*/

/*! \fn dtkMetaContainerSequential::iterator& dtkMetaContainerSequential::iterator::operator = (const iterator& o)

    Assigns \a o to \c this.
*/

/*! \fn dtkMetaContainerSequential::iterator& dtkMetaContainerSequential::iterator::operator = (iterator&& o)

    Move assignement operator.
*/

/*! \fn T& dtkMetaContainerSequential::iterator::value(void)

    Returns reference to the element referred by the current iterator.
 */

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::iterator::operator [] (qlonglong j)

    Returns a reference to the dtkMetaContainerSequential::item which
    enables to modify the element at \c *this \c + \a j pointed by the
    iterator.
*/

/*! \fn dtkMetaContainerSequential::iterator dtkMetaContainerSequential::iterator::operator ++ (int)

    The postfix ++ operator (\c{it++}) advances the iterator to the
    next element in the container and returns an iterator to the
    previously current element.
*/

/*! \fn dtkMetaContainerSequential::iterator dtkMetaContainerSequential::iterator::operator -- (int)

    The postfix -- operator (\c{it--}) makes the preceding element
    current and returns an iterator to the previously current element.

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa hasBiDirectionalIterator()
*/

/*! \fn dtkMetaContainerSequential::iterator dtkMetaContainerSequential::iterator::operator + (qlonglong j) const

    Returns an iterator to the element at \a j positions forward from
    this iterator.

    \sa operator-(), operator+=()
*/

/*! \fn dtkMetaContainerSequential::iterator dtkMetaContainerSequential::iterator::operator - (qlonglong j) const

    Returns an iterator to the item at \a j positions backward from
    this iterator.

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa operator+(), operator-=(), hasBiDirectionalIterator()
*/

// /////////////////////////////////////////////////////////////////
// dtkMetaContainerSequential::const_iterator implementation
// /////////////////////////////////////////////////////////////////

/*! \class dtkMetaContainerSequential::const_iterator
    \inmodule dtkMeta

    \brief The dtkMetaContainerSequential::const_iterator enables to
    iterate over a pointer of a container in a QVariant.

    A dtkMetaContainerSequential::const_iterator can only be created
    by a dtkMetaContainerSequential instance, and can be used in a way
    similar to other stl-style iterators.

    \snippet dtkmeta_container_sequential.cpp 3
*/

/*! \fn dtkMetaContainerSequential::const_iterator::const_iterator(HandlerConstIterator *iterator)
    \internal
*/

/*! \fn dtkMetaContainerSequential::const_iterator::const_iterator(const const_iterator& o)

    Creates a copy of \a o.
*/

/*! \fn dtkMetaContainerSequential::const_iterator::const_iterator(const_iterator&& o)

    Move constructor.
*/

/*! \fn dtkMetaContainerSequential::const_iterator::~const_iterator(void)

    Detroys the const_iterator.
*/

/*! \fn dtkMetaContainerSequential::const_iterator& dtkMetaContainerSequential::const_iterator::operator = (const const_iterator& o)

    Assigns \a o to \c this.
*/

/*! \fn dtkMetaContainerSequential::const_iterator& dtkMetaContainerSequential::const_iterator::operator = (const_iterator&& o)

    Move assignement operator.
*/

/*! \fn const QVariant dtkMetaContainerSequential::const_iterator::operator * (void) const

    Returns the current element, converted to a QVariant.
*/

/*! \fn const QVariant dtkMetaContainerSequential::const_iterator::operator [] (qlonglong j) const

    Returns the element at \c *this \c + \a j, converted to a QVariant.
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::const_iterator::operator ++ (int)

    The postfix ++ operator (\c{it++}) advances the iterator to the
    next element in the container and returns an iterator to the
    previously current element.
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::const_iterator::operator -- (int)

    The postfix -- operator (\c{it--}) makes the preceding current and
    returns an iterator to the new current element.

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa hasBiDirectionalIterator()
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::const_iterator::operator + (qlonglong j) const

    Returns an iterator to the element at \a j positions forward from
    this iterator.

    \sa operator-(), operator+=()
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::const_iterator::operator - (qlonglong j) const

    Returns an iterator to the element at \a j positions backward from
    this iterator.

    If the container in the QVariant does not support bi-directional iteration, calling this function
    leads to undefined results.

    \sa operator+(), operator+=()
*/

// /////////////////////////////////////////////////////////////////
// dtkMetaContainerSequential implementation
// /////////////////////////////////////////////////////////////////

/*! \class dtkMetaContainerSequential
    \inmodule dtkMeta

    \brief The dtkMetaContainerSequential class is an interface for a
    container encapsulated as a pointer in a QVariant.

    This interface provides usual methods to handle the container held
    within a QVariant. In the manner of QSequentialIterable, it allows
    to iterate over the container without extracting it from the
    QVariant.

    \snippet dtkmeta_container_sequential.cpp 0

    However, unlike its Qt counterpart, it provides a set of methods
    that enable to modify the elements of the container. The container
    itself is never copied.

    \snippet dtkmeta_container_sequential.cpp 1

    Moreover, in order to enable the use of arithmetic operators, the
    notion of item has been introduced together with a non const
    iterator.

    \snippet dtkmeta_container_sequential.cpp 2

    Such arithmetic operators are available for container of all integer
    and floating types. The += operator is also available for container
    of QString. By default, these operators are disabled for container
    of any other types. A warning is emitted if they are used. One can
    refer to dtkMetaContainerSequential::item to know how to enable such
    operators for other types.

    \sa QSequentialIterable, QVariant
*/

/*! \typedef dtkMetaContainerSequential::HandlerIterator
    \internal
    Synonym for dtkMetaContainerSequentialHandler::iterator
*/

/*! \typedef dtkMetaContainerSequential::HandlerConstIterator
    \internal
    Synonym for dtkMetaContainerSequentialHandler::const_iterator
*/

/*! \fn void dtkMetaContainerSequential::insert(qlonglong idx, const QVariant& v)

    Inserts the value wrapped into QVariant \a v at index position \a
    idx in the container. If \a idx is 0, the value is prepended to
    the container. If \a idx is size(), the value is appended to the
    container.

    \sa append(), prepend(), removeAt()
*/
void dtkMetaContainerSequential::insert(qlonglong idx, const QVariant& v)
{
    if (h->value_type_id == QMetaType::QVariant)
        h->insert(idx, &v);

    h->insert(idx, v.constData());
}

/*! \fn void dtkMetaContainerSequential::setAt(qlonglong idx, const QVariant& v)

    Replaces the item at index position \a idx with the value wrapped
    into the QVariant \a v.

    \a idx must be a valid index position in the container (i.e., 0 <=
    \a idx < size()).

    \sa at(), operator[](), removeAt()
*/
void dtkMetaContainerSequential::setAt(qlonglong idx, const QVariant& v)
{
    if (h->value_type_id == QMetaType::QVariant)
        h->setAt(idx, &v);

    h->setAt(idx, v.constData());
}

// ///////////////////////////////////////////////////////////////////
// Documentation of inline methods
// ///////////////////////////////////////////////////////////////////

/*! \fn dtkMetaContainerSequential::item::item(HandlerIterator *iterator)
    \internal
*/

/*! \fn dtkMetaContainerSequential::item::item(const item& o)
    \internal
*/

/*! \fn dtkMetaContainerSequential::item::item(item&& o)
    \internal
*/

/*! \fn dtkMetaContainerSequential::item::~item(void)

    Destroys the current dtkMetaContainerSequential::item and the
    dtkMetaContainerSequential::iterator to which it is related.
*/

/*! \fn const QVariant dtkMetaContainerSequential::item::value(void) const
    \overload
    Returns the element referred by the item as a QVariant.
*/

/*! \fn const T& dtkMetaContainerSequential::item::value(void) const

    Returns a const reference to the element referred by the item.
*/

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator = (const item& o)

    Assigns \a o to \c this.
*/

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator = (item&& o)

    Move assignement operator.
*/

/*! \fn bool dtkMetaContainerSequential::item::operator == (const item& o) const

    Return true if the element referred by the current item is equal to the element referred by item \a o.
 */

/*! \fn bool dtkMetaContainerSequential::item::operator != (const item& o) const

    Return true if the element referred by the current item differs from the element referred by item \a o.
 */

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator = (const T& value)

    Assigns \a value to the element referred by the item.
*/

/*! \fn bool dtkMetaContainerSequential::item::operator == (const T& value) const

    Returns \c true if the element referred by the item is equal to \a
    value. Otherwise returns \c false.
*/

/*! \fn bool dtkMetaContainerSequential::item::operator != (const T& value) const

    Returns \c true if the element referred by the item differs from
    \a value. Otherwise returns \c false.
*/

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator += (const T& value)

    When type of the element referred by the item allows it, adds \a value to the element.

    By default, this operator is enabled for integer and floating types plus QString.
*/

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator -= (const T& value)

    When type of the element referred by the item allows it, substracts \a value to the element.

    By default, this operator is enabled for integer and floating types.
*/

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator *= (const T& value)

    When type of the element referred by the item allows it, multiplies the element by  \a value.

    By default, this operator is enabled for integer and floating types.
*/

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::item::operator /= (const T& value)

    When type of the element referred by the item allows it, divides the element by  \a value.

    By default, this operator is enabled for integer and floating types.
*/

// ///////////////////////////////////////////////////////////////////

/*! \fn dtkMetaContainerSequential::item& dtkMetaContainerSequential::iterator::operator * (void)

    Returns the current element, converted to a dtkMetaContainerSequential::item.
*/

/*! \fn bool dtkMetaContainerSequential::iterator::operator == (const iterator& o) const

    Returns \c true if \a o points to the same item as this iterator;
    otherwise returns \c false.

    \sa operator!=()
*/

/*! \fn bool dtkMetaContainerSequential::iterator::operator != (const iterator& o) const

    Returns \c true if \a o points to a different item than this
    iterator; otherwise returns \c false.

    \sa operator==()
*/

/*! \fn dtkMetaContainerSequential::iterator& dtkMetaContainerSequential::iterator::operator ++ (void)

    The prefix ++ operator (\c{++it}) advances the iterator to the
    next element in the container and returns an iterator to the new
    current element.

    Calling this function on dtkMetaContainerSequential::end() leads
    to undefined results.

    \sa operator--()
*/

/*! \fn dtkMetaContainerSequential::iterator& dtkMetaContainerSequential::iterator::operator -- (void)

    The prefix -- operator (\c{--it}) makes the preceding element
    current and returns an iterator to the new current element.

    Calling this function on dtkMetaContainerSequential::begin() leads

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa operator++(), hasBiDirectionalIterator()
*/

/*! \fn dtkMetaContainerSequential::iterator& dtkMetaContainerSequential::iterator::operator += (qlonglong j)

    Advances the iterator by \a j elements.

    \sa operator-=(), operator+()
*/

/*! \fn dtkMetaContainerSequential::iterator& dtkMetaContainerSequential::iterator::operator -= (qlonglong j)

    Makes the iterator go back by \a j elements.

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa operator+=(), operator-(), hasBiDirectionalIterator()
*/

// ///////////////////////////////////////////////////////////////////

/*! \fn bool dtkMetaContainerSequential::const_iterator::operator == (const const_iterator& o) const

    Returns \c true if \a o points to the same item as this iterator;
    otherwise returns \c false.

    \sa operator!=()
*/

/*! \fn bool dtkMetaContainerSequential::const_iterator::operator != (const const_iterator& o) const

    Returns \c true if \a o points to a different item than this
    iterator; otherwise returns \c false.

    \sa operator==()
*/

/*! \fn dtkMetaContainerSequential::const_iterator& dtkMetaContainerSequential::const_iterator::operator ++ (void)

    The prefix ++ operator (\c{++it}) advances the iterator to the
    next element in the container and returns an iterator to the new
    current element.

    Calling this function on dtkMetaContainerSequential::cend() leads
    to undefined results.

    \sa operator--()
*/

/*! \fn dtkMetaContainerSequential::const_iterator& dtkMetaContainerSequential::const_iterator::operator -- (void)

    The prefix -- operator (\c{--it}) makes the preceding element
    current and returns an iterator to the new current element.

    Calling this function on dtkMetaContainerSequential::cbegin() leads

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa operator++(), hasBiDirectionalIterator()
*/

/*! \fn dtkMetaContainerSequential::const_iterator& dtkMetaContainerSequential::const_iterator::operator += (qlonglong j)

    Advances the iterator by \a j elements.

    \sa operator-=(), operator+()
*/

/*! \fn dtkMetaContainerSequential::const_iterator& dtkMetaContainerSequential::const_iterator::operator -= (qlonglong j)

    Makes the iterator go back by \a j elements.

    If the container in the QVariant does not support bi-directional
    iteration, calling this function leads to undefined results.

    \sa operator+=(), operator-(), hasBiDirectionalIterator()
*/

// ///////////////////////////////////////////////////////////////////

/*! \fn dtkMetaContainerSequential::dtkMetaContainerSequential(dtkMetaContainerSequentialHandler *handler)
    Constructs the dtkMetaContainerSequential. User must supply a concrete \a handler.
*/

/*! \fn dtkMetaContainerSequential::dtkMetaContainerSequential(const dtkMetaContainerSequential& o)

    Constructs a copy of dtkMetaContainerSequential \a o.
 */

/*! \fn dtkMetaContainerSequential::~dtkMetaContainerSequential(void)

    Destructor.
 */

/*! \fn dtkMetaContainerSequential::iterator dtkMetaContainerSequential::begin(void)

    Returns a dtkMetaContainerSequential::iterator for the beginning
    of the container. This can be used in stl-style iteration.

    \sa cbegin(), end()
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::begin(void) const
    \overload
    \sa cbegin()
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::cbegin(void) const

    Returns a dtkMetaContainerSequential::const_iterator for the beginning
    of the container. This can be used in stl-style iteration.

    \sa begin(), cend()
*/

/*! \fn dtkMetaContainerSequential::iterator dtkMetaContainerSequential::end(void)

    Returns a dtkMetaContainerSequential::iterator for the end of the
    container. This can be used in stl-style iteration.

    \sa cend(), begin()
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::end(void) const
    \overload
    \sa cend()
*/

/*! \fn dtkMetaContainerSequential::const_iterator dtkMetaContainerSequential::cend(void) const

    Returns a dtkMetaContainerSequential::const_iterator for the end
    of the container. This can be used in stl-style iteration.

    \sa cbegin(), end()
*/

/*! \fn bool dtkMetaContainerSequential::hasBiDirectionalIterator(void) const

    Returns whether it is possible to iterate over the container in
    reverse. This corresponds to the std::bidirectional_iterator_tag
    iterator trait of the const_iterator of the container.

    \sa hasRandomAccessIterator()
*/

/*! \fn bool dtkMetaContainerSequential::hasRandomAccessIterator(void) const

    Returns \c true if the const_iterator of the container matchs
    std::random_iterator_tag iterator.

    \sa hasBiDirectionalIterator()
*/

/*! \fn bool dtkMetaContainerSequential::empty(void) const

    Returns \c true if the container is empty; otherwise returns \c
    false.
*/

/*! \fn qlonglong dtkMetaContainerSequential::size(void) const

    Returns the number of items in the container.

    \sa resize(), empty()
*/

/*! \fn void dtkMetaContainerSequential::clear(void)

    Removes all the elements from the container.
*/

/*! \fn void dtkMetaContainerSequential::reserve(qlonglong size)

    With respect to the container, it enables to allocate memory for
    at least \a size elements.

    Be careful, since this method is not available for every
    container. For instance, QList does not provide it. Using it will
    prompt a warning.
*/

/*! \fn void dtkMetaContainerSequential::resize(qlonglong size)

    Sets the size of the container to \a size. The growing policy
    relies on the kind of container.

    One must notice that this method is meaningless for std::list or
    QLinkedList for instance. A warning is then prompt.

    \sa size()
*/

/*! \fn void dtkMetaContainerSequential::append(const T& value)

    Inserts \a value at the end of the container.

    \sa prepend(), insert()
*/

/*! \fn void dtkMetaContainerSequential::prepend(const T& value)

    Inserts \a value at the beginning of the container.

    \sa append(), insert()
*/

/*! \fn void dtkMetaContainerSequential::append(const QVariant& v)
    \overload
    Inserts the value wrapped into QVariant \a v at the end of the
    container.

    \sa prepend(), insert()
*/

/*! \fn void dtkMetaContainerSequential::prepend(const QVariant& v)
    \overload
    Inserts the value wrapped into QVariant \a v at the beginning of the
    container.

    \sa append(), insert()
*/

/*! \fn void dtkMetaContainerSequential::insert(qlonglong idx, const T& value)

    Inserts \a value at index position \a idx in the container. If \a
    idx is 0, the value is prepended to the container. If \a idx is
    size(), the value is appended to the container.

    \sa append(), prepend(), removeAt()
*/

/*! \fn void dtkMetaContainerSequential::setAt(qlonglong idx, const T& value)

    Replaces the item at index position \a idx with \a value.

    \a idx must be a valid index position in the container (i.e., 0 <=
    \a idx < size()).

    \sa at(), operator[](), removeAt()
*/

/*! \fn const QVariant& dtkMetaContainerSequential::at(qlonglong idx) const
    \overload
    Returns as a QVariant the item at position \a idx in the container.

    \a idx must be a valid index position in the container (i.e., 0 <=
    \a idx < size()).

    \sa operator[]()
*/

/*! \fn const T& dtkMetaContainerSequential::at(qlonglong idx) const
    Returns const reference of the item at position \a idx in the container.

    \a idx must be a valid index position in the container (i.e., 0 <=
    \a idx < size()).

    \sa operator[]()
*/

/*! \fn void dtkMetaContainerSequential::removeAt(qlonglong idx)

    Removes the element at index position \a idx.

    \sa insert(), setAt()
*/

/*! \fn dtkMetaContainerSequential::item dtkMetaContainerSequential::first(void)

    Returns a the first element of the container as a
    dtkMetaContainerSequential::item. This item can be used through
    arithmetic operators such as \c += , \c *= , \c -= , \c /= , \c ==
    or \c != provided that the type of the element supports them.

    \sa last()
*/

/*! \fn const QVariant dtkMetaContainerSequential::first(void) const
    \overload
    Returns a the first element of the container as a QVariant.

    \sa last()
*/

/*! \fn dtkMetaContainerSequential::item dtkMetaContainerSequential::last(void)

    Returns a the last element of the container as a
    dtkMetaContainerSequential::item. This item can be used through
    arithmetic operators such as \c += , \c *= , \c -= , \c /= , \c ==
    or \c != provided that the type of the element supports them.

    \sa first()
*/

/*! \fn const QVariant dtkMetaContainerSequential::last(void) const
    \overload
    Returns a the last element of the container as a QVariant.

    \sa first()
*/

/*! \fn dtkMetaContainerSequential::item dtkMetaContainerSequential::operator[](qlonglong idx)

    Returns a the element at position \a idx of the container as a
    modifiable dtkMetaContainerSequential::item.

    dtkMetaContainerSequential::item can be used through arithmetic
    operators such as \c += , \c *= , \c -= , \c /= , \c == or \c \c
    != provided that the type of the element supports them.

    \sa first(), at(), last()
*/

/*! \fn const QVariant dtkMetaContainerSequential::operator[](qlonglong idx) const

    \overload

    Same as at(\a idx).

    \sa at()
*/

/*! \fn QDebug &operator<<(QDebug debug, const dtkMetaContainerSequential& container)
    \relates dtkMetaContainerSequential

    Writes the descriptions of \a container to the stream \a debug and returns a reference to the stream.

    \code
    QVector<int> vec(55, -1);
    QVariant var = QVariant::fromValue(&vec);
    dtkMetaContainerSequential c = var.value<dtkMetaContainerSequential>();
    qDebug() << c;
    \endcode
*/