An interface for objects which accept features via addFeature(s) methods. More...

#include <qgsfeaturesink.h>

Inheritance diagram for QgsFeatureSink:

[legend]

Public Types
enum	Flag { FastInsert = 1 << 1 }
	Flags controlling how features are added to a sink. More...

enum	SinkFlag { RegeneratePrimaryKey = 1 << 1 }
	Flags that can be set on a QgsFeatureSink. More...

Public Member Functions
virtual	~QgsFeatureSink ()=default

virtual bool	addFeature (QgsFeature &feature, QgsFeatureSink::Flags flags=nullptr)
	Adds a single feature to the sink. More...

virtual bool	addFeatures (QgsFeatureList &features, QgsFeatureSink::Flags flags=nullptr)=0
	Adds a list of features to the sink. More...

virtual bool	addFeatures (QgsFeatureIterator &iterator, QgsFeatureSink::Flags flags=nullptr)
	Adds all features from the specified iterator to the sink. More...

virtual bool	flushBuffer ()
	Flushes any internal buffer which may exist in the sink, causing any buffered features to be added to the sink's destination. More...

Detailed Description

An interface for objects which accept features via addFeature(s) methods.

Since: QGIS 3.0

Definition at line 33 of file qgsfeaturesink.h.

Member Enumeration Documentation

enum QgsFeatureSink::Flag

Flags controlling how features are added to a sink.

Enumerator

FastInsert

Use faster inserts, at the cost of updating the passed features to reflect changes made at the provider.

This includes skipping the update of the passed feature IDs to match the resulting feature IDs for the feature within the data provider. Individual sink subclasses may or may not choose to respect this flag, depending on whether or not skipping this update represents a significant speed boost for the operation.

Definition at line 60 of file qgsfeaturesink.h.

enum QgsFeatureSink::SinkFlag

Flags that can be set on a QgsFeatureSink.

Not all sinks may implement all flags.

Since: QGIS 3.4

Enumerator

RegeneratePrimaryKey

This flag indicates, that a primary key field cannot be guaranteed to be unique and the sink should ignore it if somehow possible.

This should for example be set for a geopackage file if the field "fid" has a risk to contain duplicate entries. In this case sinks like QgsVectorFileWriter or QgsVectorLayerExporter will prefer to regenerate the fid instead of trying to reuse the fids provided in addFeature calls.