The feature class encapsulates a single feature including its unique ID, geometry and a list of field/values attributes. More...

#include <qgsfeature.h>

Public Member Functions
	QgsFeature (const QgsFeature &rhs)
	Copy constructor. More...

	QgsFeature (const QgsFields &fields, QgsFeatureId id=FID_NULL)
	Constructor for QgsFeature. More...

	QgsFeature (QgsFeatureId id=FID_NULL)
	Constructor for QgsFeature. More...

virtual	~QgsFeature ()

int	approximateMemoryUsage () const
	Returns the approximate RAM usage of the feature, in bytes. More...

QVariant	attribute (const QString &name) const
	Lookup attribute value by attribute name. More...

QVariant	attribute (int fieldIdx) const
	Lookup attribute value from its index. More...

int	attributeCount () const
	Returns the number of attributes attached to the feature. More...

QgsAttributes	attributes () const
	Returns the feature's attributes. More...

void	clearGeometry ()
	Removes any geometry associated with the feature. More...

bool	deleteAttribute (const QString &name)
	Removes an attribute value by field name. More...

void	deleteAttribute (int field)
	Deletes an attribute and its value. More...

const QgsSymbol *	embeddedSymbol () const
	Returns the feature's embedded symbology, or `nullptr` if the feature has no embedded symbol. More...

int	fieldNameIndex (const QString &fieldName) const
	Utility method to get attribute index from name. More...

QgsFields	fields () const
	Returns the field map associated with the feature. More...

QgsGeometry	geometry () const
	Returns the geometry associated with this feature. More...

bool	hasGeometry () const
	Returns `true` if the feature has an associated geometry. More...

QgsFeatureId	id () const
	Returns the feature ID for this feature. More...

void	initAttributes (int fieldCount)
	Initialize this feature with the given number of fields. More...

bool	isValid () const
	Returns the validity of this feature. More...

	operator QVariant () const
	Allows direct construction of QVariants from features. More...

bool	operator!= (const QgsFeature &other) const
	Compares two features. More...

QgsFeature &	operator= (const QgsFeature &rhs)
	Assignment operator. More...

bool	operator== (const QgsFeature &other) const
	Compares two features. More...

void	padAttributes (int count)
	Resizes the attributes attached to this feature by appending the specified count of NULL values to the end of the existing attributes. More...

void	resizeAttributes (int fieldCount)
	Resizes the attributes attached to this feature to the given number of fields. More...

bool	setAttribute (const QString &name, const QVariant &value)
	Insert a value into attribute, by field name. More...

bool	setAttribute (int field, const QVariant &attr)
	Sets an attribute's value by field index. More...

void	setAttributes (const QgsAttributes &attrs)
	Sets the feature's attributes. More...

void	setEmbeddedSymbol (QgsSymbol *symbol)
	Sets the feature's embedded symbol. More...

void	setFields (const QgsFields &fields, bool initAttributes=false)
	Assigns a field map with the feature to allow attribute access by attribute name. More...

void	setGeometry (const QgsGeometry &geometry)
	Set the feature's geometry. More...

void	setGeometry (std::unique_ptr< QgsAbstractGeometry > geometry)
	Set the feature's geometry. More...

void	setId (QgsFeatureId id)
	Sets the feature id for this feature. More...

void	setValid (bool validity)
	Sets the validity of the feature. More...

Properties
QgsAttributes	attributes

QgsFields	fields

QgsGeometry	geometry

Q_GADGET QgsFeatureId	id

Detailed Description

The feature class encapsulates a single feature including its unique ID, geometry and a list of field/values attributes.

Note: QgsFeature objects are implicitly shared.

Definition at line 55 of file qgsfeature.h.

Constructor & Destructor Documentation

◆ QgsFeature() [1/3]

QgsFeature::QgsFeature ( QgsFeatureId id = FID_NULL )

Constructor for QgsFeature.

Parameters

id	unique feature ID

Definition at line 39 of file qgsfeature.cpp.

◆ QgsFeature() [2/3]

QgsFeature::QgsFeature	(	const QgsFields &	fields,
		QgsFeatureId	id = `FID_NULL`
	)

Constructor for QgsFeature.

Parameters

fields	feature's fields
id	unique feature ID

Definition at line 44 of file qgsfeature.cpp.

◆ QgsFeature() [3/3]

QgsFeature::QgsFeature ( const QgsFeature & rhs )

Copy constructor.

Definition at line 51 of file qgsfeature.cpp.

◆ ~QgsFeature()

QgsFeature::~QgsFeature ( )

virtual

Definition at line 83 of file qgsfeature.cpp.

Member Function Documentation

◆ approximateMemoryUsage()

int QgsFeature::approximateMemoryUsage ( ) const

Returns the approximate RAM usage of the feature, in bytes.

This method takes into account the size of variable elements (strings, geometry, ...), but the value returned should be considered as a lower bound estimation.

Since: QGIS 3.16

Definition at line 349 of file qgsfeature.cpp.

◆ attribute() [1/2]

QVariant QgsFeature::attribute ( const QString & name ) const

Lookup attribute value by attribute name.

Field map must be associated using setFields() before this method can be used.

Parameters

name	The name of the attribute to get

Returns: The value of the attribute, or an invalid/null variant if no such name exists

See also: setFields

Definition at line 302 of file qgsfeature.cpp.

◆ attribute() [2/2]

QVariant QgsFeature::attribute ( int fieldIdx ) const

Lookup attribute value from its index.

Field map must be associated using setFields() before this method can be used.

Parameters

fieldIdx The index of the attribute to get

Returns: The value of the attribute, or an invalid/null variant if no such name exists

See also: setFields()

Definition at line 280 of file qgsfeature.cpp.

◆ attributeCount()

int QgsFeature::attributeCount ( ) const

Returns the number of attributes attached to the feature.

Since: QGIS 3.18

Definition at line 130 of file qgsfeature.cpp.

◆ attributes()

QgsAttributes QgsFeature::attributes ( ) const

Returns the feature's attributes.

See also: setAttributes

Note: Alternatively in Python: iterate feature, eg.
[attr for attr in feature]

Since: QGIS 2.9

Definition at line 125 of file qgsfeature.cpp.

◆ clearGeometry()

void QgsFeature::clearGeometry ( )

Removes any geometry associated with the feature.

See also: setGeometry(); hasGeometry()

Since: QGIS 3.0

Definition at line 159 of file qgsfeature.cpp.

◆ deleteAttribute() [1/2]

bool QgsFeature::deleteAttribute ( const QString & name )

Removes an attribute value by field name.

Field map must be associated using setFields()before this method can be used.

Parameters

name	The name of the field to delete

Returns: false if attribute name could not be converted to index

See also: setFields()

Definition at line 269 of file qgsfeature.cpp.

◆ deleteAttribute() [2/2]

void QgsFeature::deleteAttribute ( int field )

Deletes an attribute and its value.

Parameters

field the index of the field

See also: setAttribute()

Definition at line 98 of file qgsfeature.cpp.

◆ embeddedSymbol()

const QgsSymbol * QgsFeature::embeddedSymbol ( ) const

Returns the feature's embedded symbology, or nullptr if the feature has no embedded symbol.

Since: QGIS 3.20

Definition at line 288 of file qgsfeature.cpp.

◆ fieldNameIndex()

int QgsFeature::fieldNameIndex ( const QString & fieldName ) const

Utility method to get attribute index from name.

Field map must be associated using setFields() before this method can be used.

Parameters

fieldName name of field to get attribute index of

Returns: -1 if field does not exist or field map is not associated.

See also: setFields()

Definition at line 317 of file qgsfeature.cpp.

◆ fields()

QgsFields QgsFeature::fields ( ) const

Returns the field map associated with the feature.

See also: setFields()

Definition at line 180 of file qgsfeature.cpp.

◆ geometry()

QgsGeometry QgsFeature::geometry ( ) const

Returns the geometry associated with this feature.

If the feature has no geometry, an empty QgsGeometry object will be returned.

See also: hasGeometry(); setGeometry()

Definition at line 104 of file qgsfeature.cpp.

◆ hasGeometry()

bool QgsFeature::hasGeometry ( ) const

Returns true if the feature has an associated geometry.

See also: geometry()

Since: QGIS 3.0.

Definition at line 205 of file qgsfeature.cpp.

◆ id()

QgsFeatureId QgsFeature::id ( ) const

Returns the feature ID for this feature.

See also: setId()

Definition at line 93 of file qgsfeature.cpp.

◆ initAttributes()

void QgsFeature::initAttributes ( int fieldCount )

Initialize this feature with the given number of fields.

Discards any previously set attribute data.

Parameters

fieldCount Number of fields to initialize

See also: resizeAttributes()

Definition at line 210 of file qgsfeature.cpp.

◆ isValid()

bool QgsFeature::isValid ( ) const

Returns the validity of this feature.

This is normally set by the provider to indicate some problem that makes the feature invalid or to indicate a null feature.

See also: setValid()

Definition at line 191 of file qgsfeature.cpp.

◆ operator QVariant()

QgsFeature::operator QVariant ( ) const

inline

Allows direct construction of QVariants from features.

Definition at line 704 of file qgsfeature.h.

◆ operator!=()

bool QgsFeature::operator!= ( const QgsFeature & other ) const

Compares two features.

Definition at line 78 of file qgsfeature.cpp.

◆ operator=()

QgsFeature & QgsFeature::operator= ( const QgsFeature & rhs )

Assignment operator.

Definition at line 56 of file qgsfeature.cpp.

◆ operator==()

bool QgsFeature::operator== ( const QgsFeature & other ) const

Compares two features.

Definition at line 62 of file qgsfeature.cpp.

◆ padAttributes()

void QgsFeature::padAttributes ( int count )

Resizes the attributes attached to this feature by appending the specified count of NULL values to the end of the existing attributes.

See also: resizeAttributes()

Since: QGIS 3.18

Definition at line 228 of file qgsfeature.cpp.

◆ resizeAttributes()

void QgsFeature::resizeAttributes ( int fieldCount )

Resizes the attributes attached to this feature to the given number of fields.

If the new fieldCount is greater than the original number of fields then the additional attributes will be filled with NULL values. All existing attributes will remain unchanged.

If the new fieldCount is less than the original number of fields then the unwanted values will be discarded from the end of the existing attributes.

See also: initAttributes(); padAttributes()

Since: QGIS 3.18

Definition at line 219 of file qgsfeature.cpp.

◆ setAttribute() [1/2]

bool QgsFeature::setAttribute	(	const QString &	name,
		const QVariant &	value
	)

Insert a value into attribute, by field name.

Returns false if field name could not be matched.

Field map must be associated using setFields() before this method can be used.

Calling this method will automatically set the feature as valid (see isValid()).

Parameters

name	The name of the field to set
value	The value to set

Returns: false if attribute name could not be converted to index

See also: setFields()

Definition at line 257 of file qgsfeature.cpp.

◆ setAttribute() [2/2]

bool QgsFeature::setAttribute	(	int	field,
		const QVariant &	attr
	)

Sets an attribute's value by field index.

If the attribute was successfully set then the feature will be automatically marked as valid (see isValid()).

Parameters

field	the index of the field to set
attr	the value of the attribute

Returns: false, if the field index does not exist

See also: setAttributes()

Definition at line 237 of file qgsfeature.cpp.

◆ setAttributes()

void QgsFeature::setAttributes ( const QgsAttributes & attrs )

Sets the feature's attributes.

Calling this method will automatically set the feature as valid (see isValid()).

The number of provided attributes need to exactly match the number of the feature's fields.

Parameters

attrs List of attribute values

Warning: If the number of provided attributes does not exactly match the number of the feature's fields then it will not be possible to add this feature to the corresponding data provider.

See also: setAttribute(); attributes()

Definition at line 135 of file qgsfeature.cpp.

◆ setEmbeddedSymbol()

void QgsFeature::setEmbeddedSymbol ( QgsSymbol * symbol )

Sets the feature's embedded symbol.

Ownership of symbol is transferred to the feature.

Since: QGIS 3.20

Definition at line 293 of file qgsfeature.cpp.

◆ setFields()

void QgsFeature::setFields	(	const QgsFields &	fields,
		bool	initAttributes = `false`
	)

Assigns a field map with the feature to allow attribute access by attribute name.

Parameters

fields	The attribute fields which this feature holds
initAttributes	If `true`, attributes are initialized. Clears any data previously assigned.

See also: fields()

Since: QGIS 2.9

Definition at line 170 of file qgsfeature.cpp.

◆ setGeometry() [1/2]

void QgsFeature::setGeometry ( const QgsGeometry & geometry )

Set the feature's geometry.

Calling this method will automatically set the feature as valid (see isValid()).

Parameters

geometry new feature geometry

See also: geometry(); clearGeometry()

Definition at line 145 of file qgsfeature.cpp.

◆ setGeometry() [2/2]

void QgsFeature::setGeometry ( std::unique_ptr< QgsAbstractGeometry > geometry )

Set the feature's geometry.

Ownership of the geometry is transferred to the feature.

Calling this method will automatically set the feature as valid (see isValid()).

This method is a shortcut for calling:

feature.setGeometry( QgsGeometry( geometry ) )

QgsGeometry

A geometry is the spatial representation of a feature.

Definition: qgsgeometry.h:124

Example

# Sets a feature's geometry to a point geometry
feature.setGeometry( QgsPoint( 210, 41 ) )
print(feature.geometry())
# output: <QgsGeometry: Point (210 41)>
 
# Sets a feature's geometry to a line string
feature.setGeometry( QgsLineString( [ QgsPoint( 210, 41 ), QgsPoint( 301, 55 ) ] ) )
print(feature.geometry())
# output: <QgsGeometry: LineString (210 41, 301 55)>

See also: geometry(); clearGeometry()

Since: QGIS 3.6

Definition at line 152 of file qgsfeature.cpp.

◆ setId()

void QgsFeature::setId ( QgsFeatureId id )

Sets the feature id for this feature.

Parameters

id	feature id

See also: id()

Definition at line 115 of file qgsfeature.cpp.

◆ setValid()

void QgsFeature::setValid ( bool validity )

Sets the validity of the feature.

Parameters

validity set to true if feature is valid

See also: isValid()

Definition at line 196 of file qgsfeature.cpp.

Property Documentation

◆ attributes

QgsAttributes QgsFeature::attributes

readwrite

Definition at line 62 of file qgsfeature.h.

◆ fields

QgsFields QgsFeature::fields

readwrite

Definition at line 62 of file qgsfeature.h.

◆ geometry

QgsGeometry QgsFeature::geometry

readwrite

Definition at line 62 of file qgsfeature.h.

◆ id

Q_GADGET QgsFeatureId QgsFeature::id

readwrite

Definition at line 62 of file qgsfeature.h.

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

/build/qgis-3.20.0+99unstable/src/core/qgsfeature.h
/build/qgis-3.20.0+99unstable/src/core/qgsfeature.cpp

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ QgsFeature() [1/3]

◆ QgsFeature() [2/3]

◆ QgsFeature() [3/3]

◆ ~QgsFeature()

Member Function Documentation

◆ approximateMemoryUsage()

◆ attribute() [1/2]

◆ attribute() [2/2]

◆ attributeCount()

◆ attributes()

◆ clearGeometry()

◆ deleteAttribute() [1/2]

◆ deleteAttribute() [2/2]

◆ embeddedSymbol()

◆ fieldNameIndex()

◆ fields()

◆ geometry()

◆ hasGeometry()

◆ id()

◆ initAttributes()

◆ isValid()

◆ operator QVariant()

◆ operator!=()

◆ operator=()

◆ operator==()

◆ padAttributes()

◆ resizeAttributes()

◆ setAttribute() [1/2]

◆ setAttribute() [2/2]

◆ setAttributes()

◆ setEmbeddedSymbol()

◆ setFields()

◆ setGeometry() [1/2]

◆ setGeometry() [2/2]

Example

◆ setId()

◆ setValid()

Property Documentation

◆ attributes

◆ fields

◆ geometry

◆ id