QgsProxyFeatureSink Class Reference

A simple feature sink which proxies feature addition on to another feature sink. More...

#include <qgsproxyfeaturesink.h>

Inheritance diagram for QgsProxyFeatureSink:

Public Member Functions
	QgsProxyFeatureSink (QgsFeatureSink *sink)
	Constructs a new QgsProxyFeatureSink which forwards features onto a destination sink.
bool	addFeature (QgsFeature &feature, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) override
	Adds a single feature to the sink.
bool	addFeatures (QgsFeatureIterator &iterator, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) override
	Adds all features from the specified iterator to the sink.
bool	addFeatures (QgsFeatureList &features, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) override
	Adds a list of features to the sink.
QgsFeatureSink *	destinationSink ()
	Returns the destination QgsFeatureSink which the proxy will forward features to.
void	finalize () override
	Finalizes the sink, flushing any buffered features to the destination.
bool	flushBuffer () override
	Flushes any internal buffer which may exist in the sink, causing any buffered features to be added to the sink's destination.
QString	lastError () const override
	Returns the most recent error encountered by the sink, e.g.
Public Member Functions inherited from QgsFeatureSink
virtual	~QgsFeatureSink ()=default

Protected Attributes
QgsFeatureSink *	mSink = nullptr
	Underlying destination sink.

Additional Inherited Members
Public Types inherited from QgsFeatureSink
enum	Flag { FastInsert = 1 << 1 , RollBackOnErrors = 1 << 2 }
	Flags controlling how features are added to a sink. More...
typedef QFlags< Flag >	Flags
enum	SinkFlag { RegeneratePrimaryKey = 1 << 1 }
	Flags that can be set on a QgsFeatureSink. More...
typedef QFlags< SinkFlag >	SinkFlags

Detailed Description

A simple feature sink which proxies feature addition on to another feature sink.

This class is designed to allow factory methods which always return new QgsFeatureSink objects. Since it is not always possible to create an entirely new QgsFeatureSink (e.g. if the feature sink is a layer's data provider), a new QgsProxyFeatureSink can instead be returned which forwards features on to the destination sink. The proxy sink can be safely deleted without affecting the destination sink.

Definition at line 38 of file qgsproxyfeaturesink.h.

Constructor & Destructor Documentation

QgsProxyFeatureSink()

QgsProxyFeatureSink::QgsProxyFeatureSink

(

QgsFeatureSink *

sink

)

Constructs a new QgsProxyFeatureSink which forwards features onto a destination sink.

Definition at line 21 of file qgsproxyfeaturesink.cpp.

Member Function Documentation

addFeature()

bool QgsProxyFeatureSink::addFeature ( QgsFeature &  feature, QgsFeatureSink::Flags  flags = QgsFeatureSink::Flags()  )

overridevirtual

Adds a single feature to the sink.

Feature addition behavior is controlled by the specified flags.

See also

addFeatures()

Returns

true in case of success and false in case of failure

Reimplemented from QgsFeatureSink.

Definition at line 25 of file qgsproxyfeaturesink.cpp.

addFeatures() [1/2]

bool QgsProxyFeatureSink::addFeatures ( QgsFeatureIterator &  iterator, QgsFeatureSink::Flags  flags = QgsFeatureSink::Flags()  )

overridevirtual

Adds all features from the specified iterator to the sink.

Feature addition behavior is controlled by the specified flags.

Returns

true if all features were added successfully, or false if any feature could not be added

Reimplemented from QgsFeatureSink.

Definition at line 41 of file qgsproxyfeaturesink.cpp.

addFeatures() [2/2]

bool QgsProxyFeatureSink::addFeatures ( QgsFeatureList &  features, QgsFeatureSink::Flags  flags = QgsFeatureSink::Flags()  )

overridevirtual

Adds a list of features to the sink.

Feature addition behavior is controlled by the specified flags.

See also

addFeature()

Returns

true in case of success and false in case of failure

Implements QgsFeatureSink.

Definition at line 33 of file qgsproxyfeaturesink.cpp.

destinationSink()

QgsFeatureSink * QgsProxyFeatureSink::destinationSink ( )

inline

Returns the destination QgsFeatureSink which the proxy will forward features to.

Definition at line 56 of file qgsproxyfeaturesink.h.

finalize()

void QgsProxyFeatureSink::finalize ( )

overridevirtual

Finalizes the sink, flushing any buffered features to the destination.

Since

QGIS 3.42

Reimplemented from QgsFeatureSink.

Definition at line 62 of file qgsproxyfeaturesink.cpp.

flushBuffer()

bool QgsProxyFeatureSink::flushBuffer ( )

overridevirtual

Flushes any internal buffer which may exist in the sink, causing any buffered features to be added to the sink's destination.

Returns

false if any buffered features could not be added to the sink.

Reimplemented from QgsFeatureSink.

Definition at line 54 of file qgsproxyfeaturesink.cpp.

lastError()

QString QgsProxyFeatureSink::lastError ( ) const

overridevirtual

Returns the most recent error encountered by the sink, e.g.

when a call to addFeatures() returns false.

Since

QGIS 3.16

Reimplemented from QgsFeatureSink.

Definition at line 49 of file qgsproxyfeaturesink.cpp.

Member Data Documentation

mSink

QgsFeatureSink* QgsProxyFeatureSink::mSink = nullptr

protected

Underlying destination sink.

Definition at line 61 of file qgsproxyfeaturesink.h.

---

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

• /build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/core/qgsproxyfeaturesink.h
• /build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/core/qgsproxyfeaturesink.cpp