31#ifndef OGRSF_FRMTS_H_INCLUDED
32#define OGRSF_FRMTS_H_INCLUDED
34#include "cpl_progress.h"
48#if !defined(GDAL_COMPILATION) && !defined(SUPPRESS_DEPRECATION_WARNINGS)
49#define OGR_DEPRECATED(x) CPL_WARN_DEPRECATED(x)
51#define OGR_DEPRECATED(x)
55class OGRLayerAttrIndex;
70class CPL_DLL OGRLayer :
public GDALMajorObject
74 std::unique_ptr<Private> m_poPrivate;
76 void ConvertGeomsIfNecessary(
OGRFeature *poFeature );
78 class CPL_DLL FeatureIterator
81 std::unique_ptr<Private> m_poPrivate;
83 FeatureIterator(OGRLayer* poLayer,
bool bStart);
84 FeatureIterator(FeatureIterator&& oOther)
noexcept;
87 FeatureIterator& operator++();
88 bool operator!=(
const FeatureIterator& it)
const;
91 friend inline FeatureIterator
begin(OGRLayer* poLayer);
92 friend inline FeatureIterator
end(OGRLayer* poLayer);
98 int m_bFilterIsEnvelope;
100 OGRPreparedGeometry *m_pPreparedFilterGeom;
102 int m_iGeomFieldFilter;
129 FeatureIterator
begin();
132 FeatureIterator
end();
137 double dfMaxX,
double dfMaxY );
141 double dfMinX,
double dfMinY,
142 double dfMaxX,
double dfMaxY );
159 virtual
int FindFieldIndex( const
char *pszFieldName,
int bExactMatch );
171 int bApproxOK = TRUE );
177 int bApproxOK = TRUE );
196 OGRLayer *pLayerResult,
197 char** papszOptions =
nullptr,
198 GDALProgressFunc pfnProgress =
nullptr,
199 void * pProgressArg =
nullptr );
201 OGRLayer *pLayerResult,
202 char** papszOptions =
nullptr,
203 GDALProgressFunc pfnProgress =
nullptr,
204 void * pProgressArg =
nullptr );
206 OGRLayer *pLayerResult,
208 GDALProgressFunc pfnProgress,
209 void * pProgressArg );
211 OGRLayer *pLayerResult,
212 char** papszOptions =
nullptr,
213 GDALProgressFunc pfnProgress =
nullptr,
214 void * pProgressArg =
nullptr );
216 OGRLayer *pLayerResult,
217 char** papszOptions =
nullptr,
218 GDALProgressFunc pfnProgress =
nullptr,
219 void * pProgressArg =
nullptr );
221 OGRLayer *pLayerResult,
222 char** papszOptions =
nullptr,
223 GDALProgressFunc pfnProgress =
nullptr,
224 void * pProgressArg =
nullptr );
226 OGRLayer *pLayerResult,
227 char** papszOptions =
nullptr,
228 GDALProgressFunc pfnProgress =
nullptr,
229 void * pProgressArg =
nullptr );
242 int AttributeFilterEvaluationNeedsGeometry();
245 OGRErr InitializeIndexSupport( const
char * );
246 OGRLayerAttrIndex *GetIndex() {
return m_poAttrIndex; }
247 int GetGeomFieldFilter()
const {
return m_iGeomFieldFilter; }
248 const char *GetAttrQueryString()
const {
return m_pszAttrQueryString; }
255 {
return reinterpret_cast<OGRLayerH>(poLayer); }
261 {
return reinterpret_cast<OGRLayer*
>(hLayer); }
266 OGRFeatureQuery *m_poAttrQuery;
267 char *m_pszAttrQueryString;
268 OGRLayerAttrIndex *m_poAttrIndex;
287inline OGRLayer::FeatureIterator
begin(OGRLayer* poLayer) {
return poLayer->
begin(); }
292inline OGRLayer::FeatureIterator
end(OGRLayer* poLayer) {
return poLayer->
end(); }
315 const auto poThis =
static_cast<BaseLayer*
>(
this);
318 OGRFeature *poFeature = poThis->GetNextRawFeature();
319 if (poFeature ==
nullptr)
322 if((poThis->m_poFilterGeom ==
nullptr
324 && (poThis->m_poAttrQuery ==
nullptr
325 || poThis->m_poAttrQuery->Evaluate( poFeature )) )
336#define DEFINE_GET_NEXT_FEATURE_THROUGH_RAW(BaseLayer) \
338 friend class OGRGetNextFeatureThroughRaw<BaseLayer>; \
340 OGRFeature* GetNextFeature() override { return OGRGetNextFeatureThroughRaw<BaseLayer>::GetNextFeature(); }
371 virtual const char *GetName() OGR_DEPRECATED(
"Use GDALDataset class instead") = 0;
373 static void DestroyDataSource( OGRDataSource * ) OGR_DEPRECATED(
"Use GDALDataset class instead");
405 virtual const char *GetName() OGR_DEPRECATED(
"Use GDALDriver class instead") = 0;
407 virtual OGRDataSource *Open(
const char *pszName,
int bUpdate=FALSE ) OGR_DEPRECATED(
"Use GDALDriver class instead") = 0;
409 virtual int TestCapability(
const char *pszCap ) OGR_DEPRECATED(
"Use GDALDriver class instead") = 0;
411 virtual OGRDataSource *CreateDataSource(
const char *pszName,
412 char ** =
nullptr ) OGR_DEPRECATED(
"Use GDALDriver class instead");
413 virtual OGRErr DeleteDataSource(
const char *pszName ) OGR_DEPRECATED(
"Use GDALDriver class instead");
434class CPL_DLL OGRSFDriverRegistrar
437 OGRSFDriverRegistrar();
438 ~OGRSFDriverRegistrar();
443 const char * pszName,
444 char ** papszOptions );
446 const char * pszName );
450 static OGRSFDriverRegistrar *GetRegistrar() OGR_DEPRECATED(
"Use GDALDriverManager class instead");
453 void RegisterDriver(
OGRSFDriver * poDriver ) OGR_DEPRECATED(
"Use GDALDriverManager class instead");
456 int GetDriverCount(
void ) OGR_DEPRECATED(
"Use GDALDriverManager class instead");
458 GDALDriver *GetDriver(
int iDriver ) OGR_DEPRECATED(
"Use GDALDriverManager class instead");
460 GDALDriver *GetDriverByName(
const char * ) OGR_DEPRECATED(
"Use GDALDriverManager class instead");
463 int GetOpenDSCount() OGR_DEPRECATED(
"Use GDALDriverManager class instead");
465 OGRDataSource *GetOpenDS(
int ) OGR_DEPRECATED(
"Use GDALDriverManager class instead");
475void OGRRegisterAllInternal();
477void CPL_DLL RegisterOGRFileGDB();
478void CPL_DLL RegisterOGRShape();
479void CPL_DLL RegisterOGRDB2();
480void CPL_DLL RegisterOGRNTF();
481void CPL_DLL RegisterOGRFME();
482void CPL_DLL RegisterOGRSDTS();
483void CPL_DLL RegisterOGRTiger();
484void CPL_DLL RegisterOGRS57();
485void CPL_DLL RegisterOGRTAB();
486void CPL_DLL RegisterOGRMIF();
487void CPL_DLL RegisterOGROGDI();
488void CPL_DLL RegisterOGRODBC();
489void CPL_DLL RegisterOGRWAsP();
490void CPL_DLL RegisterOGRPG();
491void CPL_DLL RegisterOGRMSSQLSpatial();
492void CPL_DLL RegisterOGRMySQL();
493void CPL_DLL RegisterOGROCI();
494void CPL_DLL RegisterOGRDGN();
495void CPL_DLL RegisterOGRGML();
496void CPL_DLL RegisterOGRLIBKML();
497void CPL_DLL RegisterOGRKML();
498void CPL_DLL RegisterOGRFlatGeobuf();
499void CPL_DLL RegisterOGRGeoJSON();
500void CPL_DLL RegisterOGRGeoJSONSeq();
501void CPL_DLL RegisterOGRESRIJSON();
502void CPL_DLL RegisterOGRTopoJSON();
503void CPL_DLL RegisterOGRAVCBin();
504void CPL_DLL RegisterOGRAVCE00();
505void CPL_DLL RegisterOGRREC();
506void CPL_DLL RegisterOGRMEM();
507void CPL_DLL RegisterOGRVRT();
508void CPL_DLL RegisterOGRDODS();
509void CPL_DLL RegisterOGRSQLite();
510void CPL_DLL RegisterOGRCSV();
511void CPL_DLL RegisterOGRILI1();
512void CPL_DLL RegisterOGRILI2();
513void CPL_DLL RegisterOGRGRASS();
514void CPL_DLL RegisterOGRPGeo();
515void CPL_DLL RegisterOGRDXF();
516void CPL_DLL RegisterOGRCAD();
517void CPL_DLL RegisterOGRDWG();
518void CPL_DLL RegisterOGRDGNV8();
519void CPL_DLL RegisterOGRIDB();
520void CPL_DLL RegisterOGRGMT();
521void CPL_DLL RegisterOGRGPX();
522void CPL_DLL RegisterOGRGeoconcept();
523void CPL_DLL RegisterOGRIngres();
524void CPL_DLL RegisterOGRNAS();
525void CPL_DLL RegisterOGRGeoRSS();
526void CPL_DLL RegisterOGRGTM();
527void CPL_DLL RegisterOGRVFK();
528void CPL_DLL RegisterOGRPGDump();
529void CPL_DLL RegisterOGROSM();
530void CPL_DLL RegisterOGRGPSBabel();
531void CPL_DLL RegisterOGRPDS();
532void CPL_DLL RegisterOGRWFS();
533void CPL_DLL RegisterOGROAPIF();
534void CPL_DLL RegisterOGRSOSI();
535void CPL_DLL RegisterOGRGeomedia();
536void CPL_DLL RegisterOGRMDB();
537void CPL_DLL RegisterOGREDIGEO();
538void CPL_DLL RegisterOGRSVG();
539void CPL_DLL RegisterOGRCouchDB();
540void CPL_DLL RegisterOGRCloudant();
541void CPL_DLL RegisterOGRIdrisi();
542void CPL_DLL RegisterOGRARCGEN();
543void CPL_DLL RegisterOGRXLS();
544void CPL_DLL RegisterOGRODS();
545void CPL_DLL RegisterOGRXLSX();
546void CPL_DLL RegisterOGRElastic();
547void CPL_DLL RegisterOGRGeoPackage();
548void CPL_DLL RegisterOGRWalk();
549void CPL_DLL RegisterOGRCarto();
550void CPL_DLL RegisterOGRAmigoCloud();
551void CPL_DLL RegisterOGRSXF();
552void CPL_DLL RegisterOGROpenFileGDB();
553void CPL_DLL RegisterOGRSelafin();
554void CPL_DLL RegisterOGRJML();
555void CPL_DLL RegisterOGRPLSCENES();
556void CPL_DLL RegisterOGRCSW();
557void CPL_DLL RegisterOGRMongoDBv3();
558void CPL_DLL RegisterOGRMongoDB();
559void CPL_DLL RegisterOGRVDV();
560void CPL_DLL RegisterOGRGMLAS();
561void CPL_DLL RegisterOGRMVT();
562void CPL_DLL RegisterOGRNGW();
563void CPL_DLL RegisterOGRMapML();
564void CPL_DLL RegisterOGRLVBAG();
A set of associated raster bands, usually from one file.
Definition gdal_priv.h:340
Format specific driver.
Definition gdal_priv.h:1489
Class for dataset open functions.
Definition gdal_priv.h:269
LEGACY class.
Definition ogrsf_frmts.h:367
Simple container for a bounding region (rectangle)
Definition ogr_core.h:58
Definition of a feature class or feature layer.
Definition ogr_feature.h:279
A simple feature, including geometry and attributes.
Definition ogr_feature.h:371
OGRGeometry * GetGeometryRef()
Fetch pointer to feature geometry.
Definition ogrfeature.cpp:583
Definition of an attribute of an OGRFeatureDefn.
Definition ogr_feature.h:99
Definition of a geometry field of an OGRFeatureDefn.
Definition ogr_feature.h:202
Abstract base class for all geometry classes.
Definition ogr_geometry.h:327
Template class offering a GetNextFeature() implementation relying on GetNextRawFeature()
Definition ogrsf_frmts.h:309
OGRFeature * GetNextFeature()
Implement OGRLayer::GetNextFeature(), relying on BaseLayer::GetNextRawFeature()
Definition ogrsf_frmts.h:313
virtual OGRErr CreateField(OGRFieldDefn *poField, int bApproxOK=TRUE)
Create a new field on a layer.
Definition ogrlayer.cpp:665
virtual void SetSpatialFilter(OGRGeometry *)
Set a new spatial filter.
Definition ogrlayer.cpp:1113
friend FeatureIterator begin(OGRLayer *poLayer)
Return begin of feature iterator.
Definition ogrsf_frmts.h:287
int Dereference()
Decrement layer reference count.
Definition ogrlayer.cpp:129
virtual OGRErr DeleteFeature(GIntBig nFID)
Delete feature from layer.
Definition ogrlayer.cpp:1546
OGRErr Erase(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions=nullptr, GDALProgressFunc pfnProgress=nullptr, void *pProgressArg=nullptr)
Remove areas that are covered by the method layer.
Definition ogrlayer.cpp:4078
virtual void SetStyleTableDirectly(OGRStyleTable *poStyleTable)
Set layer style table.
Definition ogrlayer.cpp:1662
virtual OGRErr StartTransaction()
For datasources which support transactions, StartTransaction creates a transaction.
Definition ogrlayer.cpp:912
virtual const char * GetName()
Return the layer name.
Definition ogrlayer.cpp:1727
virtual GIntBig GetFeatureCount(int bForce=TRUE)
Fetch the feature count in this layer.
Definition ogrlayer.cpp:173
virtual void SetStyleTable(OGRStyleTable *poStyleTable)
Set layer style table.
Definition ogrlayer.cpp:1673
OGRErr Identity(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions=nullptr, GDALProgressFunc pfnProgress=nullptr, void *pProgressArg=nullptr)
Identify the features of this layer with the ones from the identity layer.
Definition ogrlayer.cpp:3182
virtual OGRErr GetExtent(OGREnvelope *psExtent, int bForce=TRUE)
Fetch the extent of this layer.
Definition ogrlayer.cpp:211
virtual OGRErr ICreateFeature(OGRFeature *poFeature)
Create and write a new feature within a layer.
Definition ogrlayer.cpp:637
OGRErr Intersection(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions=nullptr, GDALProgressFunc pfnProgress=nullptr, void *pProgressArg=nullptr)
Intersection of two layers.
Definition ogrlayer.cpp:2061
virtual OGRErr SetIgnoredFields(const char **papszFields)
Set which fields can be omitted when retrieving features from the layer.
Definition ogrlayer.cpp:1791
virtual OGRErr ISetFeature(OGRFeature *poFeature)
Rewrite an existing feature.
Definition ogrlayer.cpp:598
OGRErr SetFeature(OGRFeature *poFeature)
Rewrite an existing feature.
Definition ogrlayer.cpp:587
OGRErr Update(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions=nullptr, GDALProgressFunc pfnProgress=nullptr, void *pProgressArg=nullptr)
Update this layer with features from the update layer.
Definition ogrlayer.cpp:3527
virtual OGRErr CommitTransaction()
For datasources which support transactions, CommitTransaction commits a transaction.
Definition ogrlayer.cpp:939
static OGRLayerH ToHandle(OGRLayer *poLayer)
Convert a OGRLayer* to a OGRLayerH.
Definition ogrsf_frmts.h:254
virtual OGRSpatialReference * GetSpatialRef()
Fetch the spatial reference system for this layer.
Definition ogrlayer.cpp:1037
friend FeatureIterator end(OGRLayer *poLayer)
Return end of feature iterator.
Definition ogrsf_frmts.h:292
OGRErr SymDifference(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions, GDALProgressFunc pfnProgress, void *pProgressArg)
Symmetrical difference of two layers.
Definition ogrlayer.cpp:2837
virtual OGRwkbGeometryType GetGeomType()
Return the layer geometry type.
Definition ogrlayer.cpp:1754
OGRErr Clip(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions=nullptr, GDALProgressFunc pfnProgress=nullptr, void *pProgressArg=nullptr)
Clip off areas that are not covered by the method layer.
Definition ogrlayer.cpp:3819
virtual void ResetReading()=0
Reset feature reading to start on the first feature.
OGRErr CreateFeature(OGRFeature *poFeature)
Create and write a new feature within a layer.
Definition ogrlayer.cpp:626
virtual OGRErr DeleteField(int iField)
Delete an existing field on a layer.
Definition ogrlayer.cpp:701
virtual OGRErr RollbackTransaction()
For datasources which support transactions, RollbackTransaction will roll back a datasource to its st...
Definition ogrlayer.cpp:966
OGRErr ReorderField(int iOldFieldPos, int iNewFieldPos)
Reorder an existing field on a layer.
Definition ogrlayer.cpp:765
virtual OGRErr SetNextByIndex(GIntBig nIndex)
Move read cursor to the nIndex'th feature in the current resultset.
Definition ogrlayer.cpp:499
virtual OGRFeatureDefn * GetLayerDefn()=0
Fetch the schema information for this layer.
virtual OGRStyleTable * GetStyleTable()
Returns layer style table.
Definition ogrlayer.cpp:1653
virtual OGRErr SetAttributeFilter(const char *)
Set a new attribute query.
Definition ogrlayer.cpp:338
virtual int TestCapability(const char *)=0
Test if this layer supported the named capability.
virtual void SetSpatialFilterRect(double dfMinX, double dfMinY, double dfMaxX, double dfMaxY)
Set a new rectangular spatial filter.
Definition ogrlayer.cpp:1184
virtual OGRFeature * GetFeature(GIntBig nFID)
Fetch a feature by its identifier.
Definition ogrlayer.cpp:447
virtual OGRGeometry * GetSpatialFilter()
This method returns the current spatial filter for this layer.
Definition ogrlayer.cpp:1085
OGRErr Union(OGRLayer *pLayerMethod, OGRLayer *pLayerResult, char **papszOptions=nullptr, GDALProgressFunc pfnProgress=nullptr, void *pProgressArg=nullptr)
Union of two layers.
Definition ogrlayer.cpp:2407
int GetRefCount() const
Fetch reference count.
Definition ogrlayer.cpp:151
virtual OGRFeature * GetNextFeature()=0
Fetch the next available feature from this layer.
int Reference()
Increment layer reference count.
Definition ogrlayer.cpp:107
virtual OGRErr SyncToDisk()
Flush pending changes to disk.
Definition ogrlayer.cpp:1519
virtual OGRErr ReorderFields(int *panMap)
Reorder all the fields of a layer.
Definition ogrlayer.cpp:733
virtual int FindFieldIndex(const char *pszFieldName, int bExactMatch)
Find the index of field in the layer.
Definition ogrlayer.cpp:1028
virtual const char * GetFIDColumn()
This method returns the name of the underlying database column being used as the FID column,...
Definition ogrlayer.cpp:1596
static OGRLayer * FromHandle(OGRLayerH hLayer)
Convert a OGRLayerH to a OGRLayer*.
Definition ogrsf_frmts.h:260
virtual OGRErr CreateGeomField(OGRGeomFieldDefn *poField, int bApproxOK=TRUE)
Create a new geometry field on a layer.
Definition ogrlayer.cpp:876
virtual OGRErr AlterFieldDefn(int iField, OGRFieldDefn *poNewFieldDefn, int nFlagsIn)
Alter the definition of an existing field on a layer.
Definition ogrlayer.cpp:841
virtual const char * GetGeometryColumn()
This method returns the name of the underlying database column being used as the geometry column,...
Definition ogrlayer.cpp:1623
LEGACY class.
Definition ogrsf_frmts.h:400
This class represents an OpenGIS Spatial Reference System, and contains methods for converting betwee...
Definition ogr_spatialref.h:158
This class represents a style table.
Definition ogr_featurestyle.h:85
CPLErr
Error category.
Definition cpl_error.h:53
#define CPL_C_END
Macro to end a block of C symbols.
Definition cpl_port.h:331
#define CPL_C_START
Macro to start a block of C symbols.
Definition cpl_port.h:329
#define CPL_DISALLOW_COPY_ASSIGN(ClassName)
Helper to remove the copy and assignment constructors so that the compiler will not generate the defa...
Definition cpl_port.h:955
#define CPL_WARN_UNUSED_RESULT
Qualifier to warn when the return value of a function is not used.
Definition cpl_port.h:894
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition cpl_port.h:244
void * OGRLayerH
Opaque type for a layer (OGRLayer)
Definition ogr_api.h:589
OGRwkbGeometryType
List of well known binary geometry types.
Definition ogr_core.h:369
int OGRErr
Type for a OGR error.
Definition ogr_core.h:341
std::unique_ptr< OGRFeature, OGRFeatureUniquePtrDeleter > OGRFeatureUniquePtr
Unique pointer type for OGRFeature.
Definition ogr_feature.h:796
Simple feature style classes.
std::unique_ptr< OGRLayer > OGRLayerUniquePtr
Unique pointer type for OGRLayer.
Definition ogrsf_frmts.h:297
OGRLayer::FeatureIterator begin(OGRLayer *poLayer)
Return begin of feature iterator.
Definition ogrsf_frmts.h:287
OGRLayer::FeatureIterator end(OGRLayer *poLayer)
Return end of feature iterator.
Definition ogrsf_frmts.h:292