QgsFeatureIterator Class Reference

Wrapper for iterator of features from vector data provider or vector layer. More...

#include <qgsfeatureiterator.h>

Public Member Functions
	QgsFeatureIterator ()=default
	construct invalid iterator More...
	QgsFeatureIterator (QgsAbstractFeatureIterator *iter)
	construct a valid iterator More...
	QgsFeatureIterator (const QgsFeatureIterator &fi)
	copy constructor copies the iterator, increases ref.count More...
	~QgsFeatureIterator ()
	destructor deletes the iterator if it has no more references More...
bool	close ()
QgsAbstractFeatureIterator::CompileStatus	compileStatus () const
	Returns the status of expression compilation for filter expression requests. More...
bool	isClosed () const
	find out whether the iterator is still valid or closed already More...
virtual bool	isValid () const
	Will return if this iterator is valid. More...
bool	nextFeature (QgsFeature &f)
QgsFeatureIterator &	operator= (const QgsFeatureIterator &other)
bool	rewind ()
void	setInterruptionChecker (QgsFeedback *interruptionChecker)
	Attach an object that can be queried regularly by the iterator to check if it must stopped. More...

Protected Attributes
QgsAbstractFeatureIterator *	mIter = nullptr

Friends
bool	operator!= (const QgsFeatureIterator &fi1, const QgsFeatureIterator &fi2)
bool	operator== (const QgsFeatureIterator &fi1, const QgsFeatureIterator &fi2)

Detailed Description

Wrapper for iterator of features from vector data provider or vector layer.

Definition at line 253 of file qgsfeatureiterator.h.

Constructor & Destructor Documentation

QgsFeatureIterator() [1/3]

QgsFeatureIterator::QgsFeatureIterator ( )

default

construct invalid iterator

QgsFeatureIterator() [2/3]

QgsFeatureIterator::QgsFeatureIterator ( QgsAbstractFeatureIterator *  iter )

inline

construct a valid iterator

Definition at line 337 of file qgsfeatureiterator.h.

QgsFeatureIterator() [3/3]

QgsFeatureIterator::QgsFeatureIterator ( const QgsFeatureIterator &  fi )

inline

copy constructor copies the iterator, increases ref.count

Definition at line 344 of file qgsfeatureiterator.h.

~QgsFeatureIterator()

QgsFeatureIterator::~QgsFeatureIterator ( )

inline

destructor deletes the iterator if it has no more references

Definition at line 351 of file qgsfeatureiterator.h.

Member Function Documentation

close()

bool QgsFeatureIterator::close ( )

inline

Definition at line 370 of file qgsfeatureiterator.h.

compileStatus()

QgsAbstractFeatureIterator::CompileStatus QgsFeatureIterator::compileStatus ( ) const

inline

Returns the status of expression compilation for filter expression requests.

Since

QGIS 2.16

Definition at line 324 of file qgsfeatureiterator.h.

isClosed()

bool QgsFeatureIterator::isClosed ( ) const

inline

find out whether the iterator is still valid or closed already

Definition at line 378 of file qgsfeatureiterator.h.

isValid()

bool QgsFeatureIterator::isValid ( ) const

virtual

Will return if this iterator is valid.

An invalid iterator was probably introduced by a failed attempt to acquire a connection or is a default constructed iterator.

See also

isClosed to check if the iterator successfully completed and returned all the features.

Since

QGIS 3.0

Definition at line 233 of file qgsfeatureiterator.cpp.

nextFeature()

bool QgsFeatureIterator::nextFeature ( QgsFeature &  f )

inline

Definition at line 357 of file qgsfeatureiterator.h.

operator=()

QgsFeatureIterator & QgsFeatureIterator::operator=

(

const QgsFeatureIterator &

other

)

Definition at line 220 of file qgsfeatureiterator.cpp.

rewind()

bool QgsFeatureIterator::rewind ( )

inline

Definition at line 362 of file qgsfeatureiterator.h.

setInterruptionChecker()

void QgsFeatureIterator::setInterruptionChecker ( QgsFeedback *  interruptionChecker )

inline

Attach an object that can be queried regularly by the iterator to check if it must stopped.

This is mostly useful for iterators where a single nextFeature()/fetchFeature() iteration might be very long. A typical use case is the WFS provider.

Since

QGIS 2.16

Note

not available in Python bindings

Definition at line 393 of file qgsfeatureiterator.h.

Friends And Related Function Documentation

operator!=

bool operator!= ( const QgsFeatureIterator &  fi1, const QgsFeatureIterator &  fi2  )

friend

Definition at line 388 of file qgsfeatureiterator.h.

operator==

bool operator== ( const QgsFeatureIterator &  fi1, const QgsFeatureIterator &  fi2  )

friend

Definition at line 383 of file qgsfeatureiterator.h.

Member Data Documentation

mIter

QgsAbstractFeatureIterator* QgsFeatureIterator::mIter = nullptr

protected

Definition at line 330 of file qgsfeatureiterator.h.

---

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

• /tmp/buildd/qgis-3.0.2+14stretch/src/core/qgsfeatureiterator.h
• /tmp/buildd/qgis-3.0.2+14stretch/src/core/qgsfeatureiterator.cpp