Utilities for working with OGR features and layers. More...

#include <qgsogrutils.h>

Static Public Member Functions
static QStringList	cStringListToQStringList (char **stringList)
	Converts a c string list to a QStringList. More...

static QVariant	getOgrFeatureAttribute (OGRFeatureH ogrFet, const QgsFields &fields, int attIndex, QTextCodec encoding, bool ok=nullptr)
	Retrieves an attribute value from an OGR feature. More...

static QgsGeometry	ogrGeometryToQgsGeometry (OGRGeometryH geom)
	Converts an OGR geometry representation to a QgsGeometry object. More...

static QgsFeature	readOgrFeature (OGRFeatureH ogrFet, const QgsFields &fields, QTextCodec *encoding)
	Reads an OGR feature and converts it to a QgsFeature. More...

static bool	readOgrFeatureAttributes (OGRFeatureH ogrFet, const QgsFields &fields, QgsFeature &feature, QTextCodec *encoding)
	Reads all attributes from an OGR feature into a QgsFeature. More...

static bool	readOgrFeatureGeometry (OGRFeatureH ogrFet, QgsFeature &feature)
	Reads the geometry from an OGR feature into a QgsFeature. More...

static QgsFields	readOgrFields (OGRFeatureH ogrFet, QTextCodec *encoding)
	Reads an OGR feature and returns a corresponding fields collection. More...

static QgsFeatureList	stringToFeatureList (const QString &string, const QgsFields &fields, QTextCodec *encoding)
	Attempts to parse a string representing a collection of features using OGR. More...

static QgsFields	stringToFields (const QString &string, QTextCodec *encoding)
	Attempts to retrieve the fields from a string representing a collection of features using OGR. More...

Detailed Description

Utilities for working with OGR features and layers.

Contains helper utilities for assisting work with both OGR features and layers.

Note: not available in Python bindings

Since: QGIS 2.16

Definition at line 161 of file qgsogrutils.h.

Member Function Documentation

◆ cStringListToQStringList()

QStringList QgsOgrUtils::cStringListToQStringList ( char ** stringList )

static

Converts a c string list to a QStringList.

Presumes a null terminated string list.

Since: QGIS 3.2

Definition at line 520 of file qgsogrutils.cpp.

◆ getOgrFeatureAttribute()

QVariant QgsOgrUtils::getOgrFeatureAttribute	(	OGRFeatureH	ogrFet,
		const QgsFields &	fields,
		int	attIndex,
		QTextCodec *	encoding,
		bool *	ok = `nullptr`
	)

static

Retrieves an attribute value from an OGR feature.

Parameters

ogrFet	OGR feature handle
fields	fields collection corresponding to feature
attIndex	index of attribute to retrieve
encoding	text encoding
ok	optional storage for success of retrieval

Returns: attribute converted to a QVariant object

See also: readOgrFeatureAttributes()

Definition at line 170 of file qgsogrutils.cpp.

◆ ogrGeometryToQgsGeometry()

QgsGeometry QgsOgrUtils::ogrGeometryToQgsGeometry ( OGRGeometryH geom )

static

Converts an OGR geometry representation to a QgsGeometry object.

Parameters

geom	OGR geometry handle

Returns: QgsGeometry object. If conversion was not successful the geometry will be empty.

See also: readOgrFeatureGeometry()

Definition at line 343 of file qgsogrutils.cpp.

◆ readOgrFeature()

QgsFeature QgsOgrUtils::readOgrFeature	(	OGRFeatureH	ogrFet,
		const QgsFields &	fields,
		QTextCodec *	encoding
	)

static

Reads an OGR feature and converts it to a QgsFeature.

Parameters

ogrFet	OGR feature handle
fields	fields collection corresponding to feature
encoding	text encoding

Returns: valid feature if read was successful

Definition at line 87 of file qgsogrutils.cpp.

◆ readOgrFeatureAttributes()

bool QgsOgrUtils::readOgrFeatureAttributes	(	OGRFeatureH	ogrFet,
		const QgsFields &	fields,
		QgsFeature &	feature,
		QTextCodec *	encoding
	)

static

Reads all attributes from an OGR feature into a QgsFeature.

Parameters

ogrFet	OGR feature handle
fields	fields collection corresponding to feature
feature	QgsFeature to store attributes in
encoding	text encoding

Returns: true if attribute read was successful

See also: getOgrFeatureAttribute()

Definition at line 273 of file qgsogrutils.cpp.

◆ readOgrFeatureGeometry()

bool QgsOgrUtils::readOgrFeatureGeometry	(	OGRFeatureH	ogrFet,
		QgsFeature &	feature
	)

static

Reads the geometry from an OGR feature into a QgsFeature.

Parameters

ogrFet	OGR feature handle
feature	QgsFeature to store geometry in

Returns: true if geometry read was successful

See also: readOgrFeatureAttributes(); ogrGeometryToQgsGeometry()

Definition at line 294 of file qgsogrutils.cpp.

◆ readOgrFields()

QgsFields QgsOgrUtils::readOgrFields	(	OGRFeatureH	ogrFet,
		QTextCodec *	encoding
	)

static

Reads an OGR feature and returns a corresponding fields collection.

Parameters

ogrFet	OGR feature handle
encoding	text encoding

Returns: fields collection if read was successful

Definition at line 112 of file qgsogrutils.cpp.

◆ stringToFeatureList()

QgsFeatureList QgsOgrUtils::stringToFeatureList	(	const QString &	string,
		const QgsFields &	fields,
		QTextCodec *	encoding
	)

static

Attempts to parse a string representing a collection of features using OGR.

For example, this method can be used to convert a GeoJSON encoded collection to a list of QgsFeatures.

Parameters

string	string to parse
fields	fields collection to use for parsed features (

See also: stringToFields())

Parameters

encoding text encoding

Returns: list of parsed features, or an empty list if no features could be parsed

See also: stringToFields()

Definition at line 438 of file qgsogrutils.cpp.

◆ stringToFields()

QgsFields QgsOgrUtils::stringToFields	(	const QString &	string,
		QTextCodec *	encoding
	)

static

Attempts to retrieve the fields from a string representing a collection of features using OGR.

Parameters

string	string to parse
encoding	text encoding

Returns: retrieved fields collection, or an empty list if no fields could be determined from the string

See also: stringToFeatureList()

Definition at line 480 of file qgsogrutils.cpp.

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

/tmp/buildd/qgis-3.6.0+99unstable/src/core/qgsogrutils.h
/tmp/buildd/qgis-3.6.0+99unstable/src/core/qgsogrutils.cpp

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ cStringListToQStringList()

◆ getOgrFeatureAttribute()

◆ ogrGeometryToQgsGeometry()

◆ readOgrFeature()

◆ readOgrFeatureAttributes()

◆ readOgrFeatureGeometry()

◆ readOgrFields()

◆ stringToFeatureList()

◆ stringToFields()