#include <ogr_feature.h>
Public Member Functions | |
OGRFeatureDefn (const char *pszName=NULL) | |
Constructor. | |
const char * | GetName () |
Get name of this OGRFeatureDefn. | |
int | GetFieldCount () |
Fetch number of fields on this feature. | |
OGRFieldDefn * | GetFieldDefn (int i) |
Fetch field definition. | |
int | GetFieldIndex (const char *) |
Find field by name. | |
void | AddFieldDefn (OGRFieldDefn *) |
Add a new field definition. | |
OGRErr | DeleteFieldDefn (int iField) |
Delete an existing field definition. | |
OGRErr | ReorderFieldDefns (int *panMap) |
Reorder the field definitions in the array of the feature definition. | |
OGRwkbGeometryType | GetGeomType () |
Fetch the geometry base type. | |
void | SetGeomType (OGRwkbGeometryType) |
Assign the base geometry type for this layer. | |
OGRFeatureDefn * | Clone () |
Create a copy of this feature definition. | |
int | Reference () |
Increments the reference count by one. | |
int | Dereference () |
Decrements the reference count by one. | |
int | GetReferenceCount () |
Fetch current reference count. | |
void | Release () |
Drop a reference to this object, and destroy if no longer referenced. | |
int | IsGeometryIgnored () |
Determine whether the geometry can be omitted when fetching features. | |
void | SetGeometryIgnored (int bIgnore) |
Set whether the geometry can be omitted when fetching features. | |
int | IsStyleIgnored () |
Determine whether the style can be omitted when fetching features. | |
void | SetStyleIgnored (int bIgnore) |
Set whether the style can be omitted when fetching features. |
Definition of a feature class or feature layer.
This object contains schema information for a set of OGRFeatures. In table based systems, an OGRFeatureDefn is essentially a layer. In more object oriented approaches (such as SF CORBA) this can represent a class of features but doesn't necessarily relate to all of a layer, or just one layer.
This object also can contain some other information such as a name, the base geometry type and potentially other metadata.
It is reasonable for different translators to derive classes from OGRFeatureDefn with additional translator specific information.
OGRFeatureDefn::OGRFeatureDefn | ( | const char * | pszName = NULL |
) |
Constructor.
The OGRFeatureDefn maintains a reference count, but this starts at zero. It is mainly intended to represent a count of OGRFeature's based on this definition.
This method is the same as the C function OGR_FD_Create().
pszName | the name to be assigned to this layer/class. It does not need to be unique. |
References wkbUnknown.
Referenced by Clone().
void OGRFeatureDefn::AddFieldDefn | ( | OGRFieldDefn * | poNewDefn | ) |
Add a new field definition.
To add a new field definition to a layer definition, do not use this function directly, but use OGRLayer::CreateField() instead.
This method should only be called while there are no OGRFeature objects in existance based on this OGRFeatureDefn. The OGRFieldDefn passed in is copied, and remains the responsibility of the caller.
This method is the same as the C function OGR_FD_AddFieldDefn().
poNewDefn | the definition of the new field. |
Referenced by Clone().
OGRFeatureDefn * OGRFeatureDefn::Clone | ( | ) |
Create a copy of this feature definition.
Creates a deep copy of the feature definition.
References AddFieldDefn(), GetFieldCount(), GetFieldDefn(), GetGeomType(), GetName(), OGRFeatureDefn(), and SetGeomType().
OGRErr OGRFeatureDefn::DeleteFieldDefn | ( | int | iField | ) |
Delete an existing field definition.
To delete an existing field definition from a layer definition, do not use this function directly, but use OGRLayer::DeleteField() instead.
This method should only be called while there are no OGRFeature objects in existance based on this OGRFeatureDefn.
This method is the same as the C function OGR_FD_DeleteFieldDefn().
iField | the index of the field defintion. |
int OGRFeatureDefn::Dereference | ( | ) | [inline] |
Decrements the reference count by one.
This method is the same as the C function OGR_FD_Dereference().
Referenced by Release().
int OGRFeatureDefn::GetFieldCount | ( | ) | [inline] |
Fetch number of fields on this feature.
This method is the same as the C function OGR_FD_GetFieldCount().
Referenced by Clone(), OGRFeature::Clone(), OGRDataSource::CopyLayer(), OGRFeature::Equal(), OGRDataSource::ExecuteSQL(), OGRFeature::GetFieldAsDouble(), OGRFeature::GetFieldAsInteger(), OGRFeature::GetFieldAsString(), OGRFeature::IsFieldSet(), OGRFeature::OGRFeature(), OGRLayer::ReorderField(), and OGRLayer::SetIgnoredFields().
OGRFieldDefn * OGRFeatureDefn::GetFieldDefn | ( | int | iField | ) |
Fetch field definition.
This method is the same as the C function OGR_FD_GetFieldDefn().
Starting with GDAL 1.7.0, this method will also issue an error if the index is not valid.
iField | the field to fetch, between 0 and GetFieldCount()-1. |
Referenced by Clone(), OGRDataSource::CopyLayer(), OGRFeature::DumpReadable(), OGRFeature::Equal(), OGRDataSource::ExecuteSQL(), OGRFeature::GetFieldAsBinary(), OGRFeature::GetFieldAsDateTime(), OGRFeature::GetFieldAsDouble(), OGRFeature::GetFieldAsDoubleList(), OGRFeature::GetFieldAsInteger(), OGRFeature::GetFieldAsIntegerList(), OGRFeature::GetFieldAsString(), OGRFeature::GetFieldAsStringList(), OGRFeature::SetField(), OGRLayer::SetIgnoredFields(), and OGRFeature::UnsetField().
int OGRFeatureDefn::GetFieldIndex | ( | const char * | pszFieldName | ) |
Find field by name.
The field index of the first field matching the passed field name (case insensitively) is returned.
This method is the same as the C function OGR_FD_GetFieldIndex().
pszFieldName | the field name to search for. |
Referenced by OGRDataSource::CopyLayer(), and OGRLayer::SetIgnoredFields().
OGRwkbGeometryType OGRFeatureDefn::GetGeomType | ( | ) | [inline] |
Fetch the geometry base type.
Note that some drivers are unable to determine a specific geometry type for a layer, in which case wkbUnknown is returned. A value of wkbNone indicates no geometry is available for the layer at all. Many drivers do not properly mark the geometry type as 25D even if some or all geometries are in fact 25D. A few (broken) drivers return wkbPolygon for layers that also include wkbMultiPolygon.
This method is the same as the C function OGR_FD_GetGeomType().
Referenced by Clone(), OGRDataSource::CopyLayer(), and OGRLayer::GetGeomType().
const char * OGRFeatureDefn::GetName | ( | ) | [inline] |
Get name of this OGRFeatureDefn.
This method is the same as the C function OGR_FD_GetName().
Referenced by Clone(), OGRSFDriver::CopyDataSource(), OGRDataSource::CopyLayer(), OGRFeature::DumpReadable(), and OGRLayer::GetName().
int OGRFeatureDefn::GetReferenceCount | ( | ) | [inline] |
Fetch current reference count.
This method is the same as the C function OGR_FD_GetReferenceCount().
int OGRFeatureDefn::IsGeometryIgnored | ( | ) | [inline] |
Determine whether the geometry can be omitted when fetching features.
This method is the same as the C function OGR_FD_IsGeometryIgnored().
int OGRFeatureDefn::IsStyleIgnored | ( | ) | [inline] |
Determine whether the style can be omitted when fetching features.
This method is the same as the C function OGR_FD_IsStyleIgnored().
int OGRFeatureDefn::Reference | ( | ) | [inline] |
Increments the reference count by one.
The reference count is used keep track of the number of OGRFeature objects referencing this definition.
This method is the same as the C function OGR_FD_Reference().
Referenced by OGRFeature::OGRFeature().
OGRErr OGRFeatureDefn::ReorderFieldDefns | ( | int * | panMap | ) |
Reorder the field definitions in the array of the feature definition.
To reorder the field definitions in a layer definition, do not use this function directly, but use OGR_L_ReorderFields() instead.
This method should only be called while there are no OGRFeature objects in existance based on this OGRFeatureDefn.
This method is the same as the C function OGR_FD_ReorderFieldDefns().
panMap | an array of GetFieldCount() elements which is a permutation of [0, GetFieldCount()-1]. panMap is such that, for each field definition at position i after reordering, its position before reordering was panMap[i]. |
void OGRFeatureDefn::SetGeometryIgnored | ( | int | bIgnore | ) | [inline] |
Set whether the geometry can be omitted when fetching features.
This method is the same as the C function OGR_FD_SetGeometryIgnored().
bIgnore | ignore state |
Referenced by OGRLayer::SetIgnoredFields().
void OGRFeatureDefn::SetGeomType | ( | OGRwkbGeometryType | eNewType | ) |
Assign the base geometry type for this layer.
All geometry objects using this type must be of the defined type or a derived type. The default upon creation is wkbUnknown which allows for any geometry type. The geometry type should generally not be changed after any OGRFeatures have been created against this definition.
This method is the same as the C function OGR_FD_SetGeomType().
eNewType | the new type to assign. |
Referenced by Clone().
void OGRFeatureDefn::SetStyleIgnored | ( | int | bIgnore | ) | [inline] |
Set whether the style can be omitted when fetching features.
This method is the same as the C function OGR_FD_SetStyleIgnored().
bIgnore | ignore state |
Referenced by OGRLayer::SetIgnoredFields().