GDAL OGR C++ API 学习之路 （3）OGRFeature 篇 代码示例

Reset

void Reset()

将 OGRFeature 的状态重置为构造后的状态

OGRFeature* feature = new OGRFeature(featureDefn);
// 设置要素的属性和几何信息
...
// 重置要素，清除所有属性和几何信息
feature->Reset();
// 重新设置要素的属性和几何信息
...

Clone

OGRFeature *Clone（） const        方法与 C 函数 OGR_F_Clone（） 相同

克隆要素

返回:  新要素，与此要素完全匹配

OGRFeature *feature = layer->GetFeature(0);
OGRFeature *cloned_feature = feature->Clone();

Equal

virtual OGRBoolean Equal（const OGRFeature *poFeature） const        方法与 C 函数 OGR_F_Equal（） 相同

参数:

poFeature – 测试这个的另一个功能。

返回:  如果它们相等，则为 TRUE，否则为 FALSE

OGRFeature* feat1 = layer->GetFeature(0);
OGRFeature* feat2 = layer->GetFeature(1);

if (feat1->Equal(feat2)) {
    cout << "Features are equal." << endl;
} else {
    cout << "Features are not equal." << endl;
}

• 两个对象共享相同的OGRFeatureDefn，即它们具有相同的属性表结构。
• 两个对象具有相同的字段值，即它们所有属性的值都相等。
• 两个对象具有相同的几何，即它们的几何对象相等（由OGRGeometry::Equal()函数测试）。
• 两个对象具有相同的特征ID，即它们在数据源中的位置相同。

GetFieldCount

inline int GetFieldCount（） const        方法与 C 函数 OGR_F_GetFieldCount（） 相同

获取此功能的字段数

返回:  字段计数

int fieldCount = poFeature->GetFieldCount();
printf("Feature has %d fields\n", fieldCount);

GetFieldDefnRef

inline const OGRFieldDefn *GetFieldDefnRef（int iField） const         inline OGRFieldDefn *GetFieldDefnRef（int iField)         此方法与 C 函数 OGR_F_GetFieldDefnRef（） 相同

获取此非几何字段的定义

参数:

iField – 要获取的字段，从 0 到 GetFieldCount（）-1。

返回:  字段定义（来自 OGRFeatureDefn）。这是一个内部引用，不应删除或修改

OGRFeature* poFeature;
int iField = 0;  // 获取第一个字段定义
OGRFieldDefn* poFieldDefn = poFeature->GetFieldDefnRef(iField);
if (poFieldDefn != nullptr) {
    printf("Field name: %s\n", poFieldDefn->GetNameRef());
    printf("Field type: %d\n", poFieldDefn->GetType());
    printf("Field width: %d\n", poFieldDefn->GetWidth());
    printf("Field precision: %d\n", poFieldDefn->GetPrecision());
}

GetFieldIndex

inline int GetFieldIndex（const char *pszName） const         此方法与 C 函数 OGR_F_GetFieldIndex（） 相同

获取给定字段名称的字段索引

参数:

pszName – 要搜索的字段的名称。

返回: 字段索引，如果未找到匹配的字段，则为 -1

int idx = feature->GetFieldIndex("fieldName");

IsFieldSet

int IsFieldSet（int iField） const        方法与 C 函数 OGR_F_IsFieldSet（） 相同

测试字段是否曾经被分配过值

参数:

iField – 要测试的字段。

返回: 如果已设置该字段，则为 TRUE，否则为 false

int iField = 0;  // 要检查的字段索引
if (poFeature->IsFieldSet(iField)) {
    // 字段已设置
} else {
    // 字段未设置
}

UnsetField

void UnsetField（int iField)        与 C 函数 OGR_F_UnsetField（） 相同。

清除字段，将其标记为未设置。

参数:

iField – 要取消设置的字段。

int iField = 0;  // 要检查的字段索引
poFeature->UnsetField(iField);

IsFieldNull

bool IsFieldNull（int iField） const         与 C 函数 OGR_F_IsFieldNull（） 相同

测试字段是否为空

参数:

iField – 要测试的字段。

返回:  如果字段为空，则为 TRUE，否则为 false。

OGRFeature* poFeature = ...; // 假设已经定义了一个OGRFeature对象
int fieldIndex = 1; // 假设需要检查第2个字段是否为NULL
bool isNull = poFeature->IsFieldNull(fieldIndex);
if(isNull) {
    printf("Field %d is NULL.\n", fieldIndex);
} else {
    printf("Field %d is not NULL.\n", fieldIndex);
}

IsFieldNull和IsFieldSet对比：

• 一个字段没有被设置值，IsFieldNull返回true，而IsFieldSet返回false
• 一个字段设置为一个非NULL值，IsFieldNull返回false，而IsFieldSet返回ture
• 一个字段被设置了 NULL 值，IsFieldSet() 也会返回 true，而 IsFieldNull() 返回 true

SetFieldNull

void SetFieldNull（int iField)        与 C 函数 OGR_F_SetFieldNull（） 相同

清除字段，将其标记为空。

参数:

iField – 要设置为 null 的字段。

int iField = 0;  // 要检查的字段索引
poFeature->SetFieldNull(iField);

SetFieldNull和UnsetField对比：

清除字段的操作会将其标记为空，而不是未设置。当一个字段被标记为空时，表示它被设置了一个特殊的NULL值，而未设置的字段则表示它们根本没有被赋值。因此，将字段清除后，它将被视为已设置但为空

IsFieldSetAndNotNull

bool IsFieldSetAndNotNull（int iField） const         与 C 函数 OGR_F_IsFieldSetAndNotNull（） 相同。

测试字段是否已设置且不为空。           

参数:

iField – 要测试的字段。

返回:  如果字段已设置，则为 TRUE，是null或者未设置，否则为 false。

bool isSet = feature->IsFieldSetAndNotNull(0);