QPatternist::UnionIterator Class Reference

Implements the except operator. That is, the computation of the sequence of nodes from one sequence, that doesn't appear in the other. More...

#include <qunioniterator_p.h>

Inheritance diagram for QPatternist::UnionIterator:

Public Functions
virtual Item::Iterator::Ptr	copy () const
	Copies this QAbstractXmlForwardIterator and returns the copy. More...
virtual Item	current () const
	Returns the current item in the sequence. More...
virtual Item	next ()
	Returns the next item in the sequence, or a null object if the end has been reached. More...
virtual xsInteger	position () const
	Returns the current position in the sequence represented by this. More...
	UnionIterator (const Item::Iterator::Ptr &it1, const Item::Iterator::Ptr &it2)
Public Functions inherited from QAbstractXmlForwardIterator< T >
virtual qint64	count ()
	Determines the number of items this QAbstractXmlForwardIterator represents. More...
virtual bool	isEmpty ()
	Returns true if the sequence is empty. More...
virtual T	last ()
	Returns the item at the end of this QAbstractXmlForwardIterator. More...
	QAbstractXmlForwardIterator ()
	Default constructor. More...
virtual qint64	sizeHint () const
	Gives a hint to the size of the contained sequence. More...
virtual QList< T >	toList ()
	Performs a copy of this QAbstractXmlForwardIterator(with copy()), and returns its items in a QList. More...
virtual QAbstractXmlForwardIterator< T >::Ptr	toReversed ()
	Returns a reverse iterator for the sequence. More...
virtual	~QAbstractXmlForwardIterator ()
	Destructor. More...
Public Functions inherited from QSharedData
	QSharedData ()
	Constructs a QSharedData object with a reference count of 0. More...
	QSharedData (const QSharedData &)
	Constructs a QSharedData object with reference count 0. More...

Private Functions
Item	nextFromFirstOperand ()

Properties
Item	m_current
const Item::Iterator::Ptr	m_it1
const Item::Iterator::Ptr	m_it2
Item	m_node1
Item	m_node2
xsInteger	m_position

Additional Inherited Members
Public Types inherited from QAbstractXmlForwardIterator< T >
typedef QList< QExplicitlySharedDataPointer< QAbstractXmlForwardIterator< T > > >	List
	A QList containing QAbstractXmlForwardIterator::Ptr instances. More...
typedef QExplicitlySharedDataPointer< QAbstractXmlForwardIterator< T > >	Ptr
	A smart pointer wrapping an instance of a QAbstractXmlForwardIterator subclass. More...
typedef QVector< QExplicitlySharedDataPointer< QAbstractXmlForwardIterator< T > > >	Vector
	A QVector containing QAbstractXmlForwardIterator::Ptr instances. More...
Public Variables inherited from QSharedData
QAtomicInt	ref
Related Functions inherited from QAbstractXmlForwardIterator< T >
template<typename TResult , typename TSource , typename TMapper >
static QAbstractXmlForwardIterator< TResult >::Ptr	makeSequenceMappingIterator (const TMapper &mapper, const QExplicitlySharedDataPointer< QAbstractXmlForwardIterator< TSource > > &source, const DynamicContext::Ptr &context)
	An object generator for SequenceMappingIterator. More...
bool	qIsForwardIteratorEnd (const T &unit)
	The Callback QAbstractXmlForwardIterator uses for determining whether unit is the end of a sequence. More...

Detailed Description

Implements the except operator. That is, the computation of the sequence of nodes from one sequence, that doesn't appear in the other.

Definition at line 70 of file qunioniterator_p.h.

Constructors and Destructors

UnionIterator()

UnionIterator::UnionIterator	(	const Item::Iterator::Ptr &	it1,
		const Item::Iterator::Ptr &	it2
	)

It is assumed that it1 and it2 are in document order and without duplicates.

Definition at line 50 of file qunioniterator.cpp.

Referenced by copy().

                                                         : m_it1(it1),
                                                               m_it2(it2),
                                                               m_position(0),
                                                               m_node1(m_it1->next()),
                                                               m_node2(m_it2->next())
{
    Q_ASSERT(m_it1);
    Q_ASSERT(m_it2);
}

Functions

copy()

Item::Iterator::Ptr UnionIterator::copy ( ) const

virtual

Copies this QAbstractXmlForwardIterator and returns the copy.

Warning

This function is not part of the public interface.

A copy and the original instance are completely independent of each other. Because evaluating an QAbstractXmlForwardIterator modifies it, one should always use a copy when an QAbstractXmlForwardIterator needs to be used several times.

Reimplemented from QAbstractXmlForwardIterator< T >.

Definition at line 126 of file qunioniterator.cpp.

{
    return Item::Iterator::Ptr(new UnionIterator(m_it1->copy(), m_it2->copy()));
}

current()

Item UnionIterator::current ( ) const

virtual

Returns the current item in the sequence.

If this function is called before the first call to next(), a null object is returned. If the end of the sequence has been reached, a null object is returned.

Implements QAbstractXmlForwardIterator< T >.

Definition at line 116 of file qunioniterator.cpp.

{
    return m_current;
}

next()

Item UnionIterator::next ( )

virtual

Returns the next item in the sequence, or a null object if the end has been reached.

Implements QAbstractXmlForwardIterator< T >.

Definition at line 61 of file qunioniterator.cpp.

{
    ++m_position;
    if(m_node1 && m_node2)
    {
        if(m_node1.asNode().model() != m_node2.asNode().model())
        {
            m_current = m_node1;
            m_node1 = m_it1->next();
            return m_current;
        }

        switch(m_node1.asNode().compareOrder(m_node2.asNode()))
        {
            case QXmlNodeModelIndex::Precedes:
            {
                m_current = m_node1;
                m_node1 = m_it1->next();
                return m_current;
            }
            case QXmlNodeModelIndex::Follows:
            {
                m_current = m_node2;
                m_node2 = m_it2->next();
                return m_current;
            }
            default:
            {
                m_current = m_node2;
                m_node1 = m_it1->next();
                m_node2 = m_it2->next();
                return m_current;
            }
        }
    }

    if(m_node1)
    {
        m_current = m_node1;
        m_node1 = m_it1->next();
        return m_current;
    }

    if(m_node2)
    {
        m_current = m_node2;
        m_node2 = m_it2->next();
        return m_current;
    }

    m_current.reset();
    m_position = -1;
    return Item();
}

nextFromFirstOperand()

Item QPatternist::UnionIterator::nextFromFirstOperand ( )

inlineprivate

Definition at line 86 of file qunioniterator_p.h.

        {
            ++m_position;
            m_current = m_node1;
            m_node1 = m_it1->next();
            return m_current;
        }

position()

xsInteger UnionIterator::position ( ) const

virtual

Returns the current position in the sequence represented by this.

The first position is 1, not 0. If next() hasn't been called, 0 is returned. If this has reached the end, -1 is returned.

Implements QAbstractXmlForwardIterator< T >.

Definition at line 121 of file qunioniterator.cpp.

{
    return m_position;
}

Properties

m_current

Item QPatternist::UnionIterator::m_current

private

Definition at line 96 of file qunioniterator_p.h.

Referenced by current(), next(), and nextFromFirstOperand().

m_it1

const Item::Iterator::Ptr QPatternist::UnionIterator::m_it1

private

Definition at line 94 of file qunioniterator_p.h.

Referenced by copy(), next(), nextFromFirstOperand(), and UnionIterator().

m_it2

const Item::Iterator::Ptr QPatternist::UnionIterator::m_it2

private

Definition at line 95 of file qunioniterator_p.h.

Referenced by copy(), next(), and UnionIterator().

m_node1

Item QPatternist::UnionIterator::m_node1

private

Definition at line 98 of file qunioniterator_p.h.

Referenced by next(), and nextFromFirstOperand().

m_node2

Item QPatternist::UnionIterator::m_node2

private

Definition at line 99 of file qunioniterator_p.h.

Referenced by next().

m_position

xsInteger QPatternist::UnionIterator::m_position

private

Definition at line 97 of file qunioniterator_p.h.

Referenced by next(), nextFromFirstOperand(), and position().

---

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

• /src/xmlpatterns/iterators/qunioniterator_p.h
• /src/xmlpatterns/iterators/qunioniterator.cpp