Soprano  2.9.4
Public Member Functions | List of all members
Soprano::NodeIterator Class Reference

An iterator that provides a stream of Nodes. More...

#include <Soprano/NodeIterator>

+ Inheritance diagram for Soprano::NodeIterator:

Public Member Functions

 NodeIterator ()
 
 NodeIterator (IteratorBackend< Node > *sti)
 
 NodeIterator (const NodeIterator &sti)
 
virtual ~NodeIterator ()
 
NodeIteratoroperator= (const NodeIterator &)
 
QList< NodeallNodes ()
 
- Public Member Functions inherited from Soprano::Iterator< Node >
 Iterator ()
 
 Iterator (IteratorBackend< Node > *sti)
 
 Iterator (const Iterator &sti)
 
virtual ~Iterator ()
 
Iteratoroperator= (const Iterator &)
 
void close ()
 
bool next ()
 
Node current () const
 
Node operator* () const
 
bool isValid () const
 
QList< NodeallElements ()
 
- Public Member Functions inherited from Soprano::Error::ErrorCache
virtual ~ErrorCache ()
 
virtual Error lastError () const
 

Additional Inherited Members

- Protected Member Functions inherited from Soprano::Iterator< Node >
void setBackend (IteratorBackend< Node > *b)
 
IteratorBackend< Node > * backend () const
 
- Protected Member Functions inherited from Soprano::Error::ErrorCache
 ErrorCache ()
 
void clearError () const
 
void setError (const Error &) const
 
void setError (const QString &errorMessage, int code=ErrorUnknown) const
 

Detailed Description

An iterator that provides a stream of Nodes.

The most common use of NodeIterator is through Model::listContexts().

Many backends do lock the underlying Model during iteration. Thus, it is always a good idea to cache the results if they are to be used to modify the model to prevent a deadlock:

Soprano::NodeIterator it = model->listContexts();
Q_FOREACH( Soprano::Node n, allNodes ) {
modifyTheModel( model, n );
}
QList< T > allElements()
An iterator that provides a stream of Nodes.
Definition: nodeiterator.h:73
QList< Node > allNodes()
Definition: nodeiterator.h:101
A Node represents one RDF resource.
Definition: node.h:54

Iterators have to be closed. This can either be achieved by deleting the iterator, finishing it (next() does return false), or calling close(). Before that other operations on the Model may block.

Iterators are not thread-safe. Two threads using the same iterator may result in undefined behaviour and even crashes. An iterator needs to be closed by the same thread that opened it (except if the iterator contains special code to handle such a situation.)

Warning
Be aware that iterators in Soprano are shared objects which means that copies of one iterator object work on the same data.

For further details on Soprano iterators see Iterator.

Author
Sebastian Trueg trueg.nosp@m.@kde.nosp@m..org

Definition at line 72 of file nodeiterator.h.

Constructor & Destructor Documentation

◆ NodeIterator() [1/3]

Soprano::NodeIterator::NodeIterator ( )

Creates and empty, invalid iterator.

◆ NodeIterator() [2/3]

Soprano::NodeIterator::NodeIterator ( IteratorBackend< Node > *  sti)

Create a new NodeIterator instance that uses sti as backend. NodeIterator will take ownership of the backend.

◆ NodeIterator() [3/3]

Soprano::NodeIterator::NodeIterator ( const NodeIterator sti)

◆ ~NodeIterator()

virtual Soprano::NodeIterator::~NodeIterator ( )
virtual

Member Function Documentation

◆ operator=()

NodeIterator& Soprano::NodeIterator::operator= ( const NodeIterator )

◆ allNodes()

QList<Node> Soprano::NodeIterator::allNodes ( )
inline

Convenience method which extracts all nodes (this does not include the nodes that have already been read from the iterator) from the iterator and returns them in a list.

Be aware that after calling this method the iterator will be invalid.

Returns
A list of all nodes that rest in the iterator.

Definition at line 101 of file nodeiterator.h.


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