OGR
Public Member Functions | Static Public Member Functions | List of all members
OGRFieldDefn Class Reference

#include <ogr_feature.h>

Public Member Functions

 OGRFieldDefn (const char *, OGRFieldType)
 Constructor. More...
 
 OGRFieldDefn (OGRFieldDefn *)
 Constructor. More...
 
void SetName (const char *)
 Reset the name of this field. More...
 
const char * GetNameRef ()
 Fetch name of this field. More...
 
OGRFieldType GetType ()
 Fetch type of this field. More...
 
void SetType (OGRFieldType eTypeIn)
 Set the type of this field. This should never be done to an OGRFieldDefn that is already part of an OGRFeatureDefn. More...
 
OGRJustification GetJustify ()
 Get the justification for this field. More...
 
void SetJustify (OGRJustification eJustifyIn)
 Set the justification for this field. More...
 
int GetWidth ()
 Get the formatting width for this field. More...
 
void SetWidth (int nWidthIn)
 Set the formatting width for this field in characters. More...
 
int GetPrecision ()
 Get the formatting precision for this field. This should normally be zero for fields of types other than OFTReal. More...
 
void SetPrecision (int nPrecisionIn)
 Set the formatting precision for this field in characters. More...
 
void Set (const char *, OGRFieldType, int=0, int=0, OGRJustification=OJUndefined)
 Set defining parameters for a field in one call. More...
 
void SetDefault (const OGRField *)
 Set default field value. More...
 
int IsIgnored ()
 Return whether this field should be omitted when fetching features. More...
 
void SetIgnored (int bIgnore)
 Set whether this field should be omitted when fetching features. More...
 
int IsSame (const OGRFieldDefn *) const
 Test if the field definition is identical to the other one. More...
 

Static Public Member Functions

static const char * GetFieldTypeName (OGRFieldType)
 Fetch human readable name for a field type. More...
 

Detailed Description

Definition of an attribute of an OGRFeatureDefn.

Constructor & Destructor Documentation

OGRFieldDefn::OGRFieldDefn ( const char *  pszNameIn,
OGRFieldType  eTypeIn 
)

Constructor.

Parameters
pszNameInthe name of the new field.
eTypeInthe type of the new field.

Referenced by OGR_Fld_Create().

OGRFieldDefn::OGRFieldDefn ( OGRFieldDefn poPrototype)

Constructor.

Create by cloning an existing field definition.

Parameters
poPrototypethe field definition to clone.

References GetJustify(), GetNameRef(), GetPrecision(), GetType(), GetWidth(), SetJustify(), SetPrecision(), and SetWidth().

Member Function Documentation

const char * OGRFieldDefn::GetFieldTypeName ( OGRFieldType  eType)
static

Fetch human readable name for a field type.

This static method is the same as the C function OGR_GetFieldTypeName().

Parameters
eTypethe field type to get name for.
Returns
pointer to an internal static name string. It should not be modified or freed.

References OFTBinary, OFTDate, OFTDateTime, OFTInteger, OFTIntegerList, OFTReal, OFTRealList, OFTString, OFTStringList, and OFTTime.

Referenced by OGRFeature::DumpReadable(), and OGR_GetFieldTypeName().

OGRJustification OGRFieldDefn::GetJustify ( )
inline

Get the justification for this field.

This method is the same as the C function OGR_Fld_GetJustify().

Returns
the justification.

Referenced by OGRFieldDefn().

const char * OGRFieldDefn::GetNameRef ( )
inline
int OGRFieldDefn::GetPrecision ( )
inline

Get the formatting precision for this field. This should normally be zero for fields of types other than OFTReal.

This method is the same as the C function OGR_Fld_GetPrecision().

Returns
the precision.

Referenced by OGRFeature::GetFieldAsString(), OGR_DS_GetLayerByName(), and OGRFieldDefn().

OGRFieldType OGRFieldDefn::GetType ( )
inline
int OGRFieldDefn::GetWidth ( )
inline

Get the formatting width for this field.

This method is the same as the C function OGR_Fld_GetWidth().

Returns
the width, zero means no specified width.

Referenced by OGRFeature::GetFieldAsString(), OGR_DS_GetLayerByName(), and OGRFieldDefn().

int OGRFieldDefn::IsIgnored ( )
inline

Return whether this field should be omitted when fetching features.

This method is the same as the C function OGR_Fld_IsIgnored().

Returns
ignore state
int OGRFieldDefn::IsSame ( const OGRFieldDefn poOtherFieldDefn) const

Test if the field definition is identical to the other one.

Parameters
poOtherFieldDefnthe other field definition to compare to.
Returns
TRUE if the field definition is identical to the other one.

Referenced by OGRFeatureDefn::IsSame().

void OGRFieldDefn::Set ( const char *  pszNameIn,
OGRFieldType  eTypeIn,
int  nWidthIn = 0,
int  nPrecisionIn = 0,
OGRJustification  eJustifyIn = OJUndefined 
)

Set defining parameters for a field in one call.

This method is the same as the C function OGR_Fld_Set().

Parameters
pszNameInthe new name to assign.
eTypeInthe new type (one of the OFT values like OFTInteger).
nWidthInthe preferred formatting width. Defaults to zero indicating undefined.
nPrecisionInnumber of decimals places for formatting, defaults to zero indicating undefined.
eJustifyInthe formatting justification (OJLeft or OJRight), defaults to OJUndefined.

References SetJustify(), SetName(), SetPrecision(), SetType(), and SetWidth().

void OGRFieldDefn::SetDefault ( const OGRField puDefaultIn)

Set default field value.

Currently use of OGRFieldDefn "defaults" is discouraged. This feature may be fleshed out in the future.

References OFTInteger, OFTReal, and OFTString.

void OGRFieldDefn::SetIgnored ( int  ignore)
inline

Set whether this field should be omitted when fetching features.

This method is the same as the C function OGR_Fld_SetIgnored().

Parameters
ignoreignore state

Referenced by OGRLayer::SetIgnoredFields().

void OGRFieldDefn::SetJustify ( OGRJustification  eJustify)
inline

Set the justification for this field.

This method is the same as the C function OGR_Fld_SetJustify().

Parameters
eJustifythe new justification.

Referenced by OGRFieldDefn(), and Set().

void OGRFieldDefn::SetName ( const char *  pszNameIn)

Reset the name of this field.

This method is the same as the C function OGR_Fld_SetName().

Parameters
pszNameInthe new name to apply.

References CPLStrdup().

Referenced by OGR_DS_GetLayerByName(), OGR_L_SetIgnoredFields(), and Set().

void OGRFieldDefn::SetPrecision ( int  nPrecision)
inline

Set the formatting precision for this field in characters.

This should normally be zero for fields of types other than OFTReal.

This method is the same as the C function OGR_Fld_SetPrecision().

Parameters
nPrecisionthe new precision.

Referenced by OGR_DS_GetLayerByName(), OGRFieldDefn(), and Set().

void OGRFieldDefn::SetType ( OGRFieldType  eType)
inline

Set the type of this field. This should never be done to an OGRFieldDefn that is already part of an OGRFeatureDefn.

This method is the same as the C function OGR_Fld_SetType().

Parameters
eTypethe new field type.

Referenced by OGR_DS_GetLayerByName(), OGRGeocodeDestroySession(), and Set().

void OGRFieldDefn::SetWidth ( int  nWidth)
inline

Set the formatting width for this field in characters.

This method is the same as the C function OGR_Fld_SetWidth().

Parameters
nWidththe new width.

Referenced by OGR_DS_GetLayerByName(), OGRFieldDefn(), and Set().


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

Generated for GDAL by doxygen 1.8.11.