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

GetStyleTable

virtual OGRStyleTable *GetStyleTable ()

返回图层样式表

返回:  指向不应由调用方修改或释放的样式表的指针

// 假设图层对象为 poLayer
OGRStyleTable* poStyleTable = poLayer->GetStyleTable();
if (poStyleTable != nullptr) {// 处理样式表信息// ...
} else {// 图层没有关联样式表// ...
}

SetStyleTableDirect

virtual void SetStyleTableDirect（OGRStyleTable *poStyleTable )

设置图层样式表

参数:

poStyleTable -- 指向要设置的样式表的指针

// 假设图层对象为 poLayer，样式表对象为 poStyleTable
poLayer->SetStyleTableDirect(poStyleTable);

StartTransaction

Virtual OGRErr StartTransaction()

对于支持事务的数据源，StartTransaction 会创建一个事务

返回:  OGRERR_NONE成功

// 假设图层对象为 poLayer
if (poLayer->StartTransaction() == OGRERR_NONE) {// 在事务中进行一系列操作// ...// 提交事务poLayer->CommitTransaction();
} else {// 处理事务启动失败的情况
}

在 OGR 中，图层可以支持事务，通过调用 StartTransaction() 可以在图层中开始一个事务。在事务中，可以进行一系列的图层操作，例如添加要素、修改要素、删除要素等。当所有的操作都执行完成后，可以调用 CommitTransaction() 来提交事务，表示所有操作都成功执行。如果在事务过程中出现了错误，可以调用 RollbackTransaction() 来回滚事务，表示撤销之前的所有操作

 

CommitTransaction

virtual OGRErr CommitTransaction()

对于支持事务的数据源，提交事务提交事务

返回:  OGRERR_NONE成功

RollbackTransaction

Virtual OGRErr RollbackTransaction()

对于支持事务的数据源，RollbackTransaction 会将数据源回滚到当前事务开始之前的状态

返回:  OGRERR_NONE成功

    // 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 开始事务poDS->StartTransaction();// 创建新要素OGRFeature* poFeature = new OGRFeature(poLayer->GetLayerDefn());// 设置要素属性poFeature->SetField("name", "New Feature");poFeature->SetField("population", 10000);// 创建新几何图形并设置为要素的几何图形OGRPoint point(100, 200);poFeature->SetGeometry(&point);// 将新要素添加到图层中if (poLayer->CreateFeature(poFeature) != OGRERR_NONE) {printf("添加要素失败！\n");poDS->RollbackTransaction(); // 回滚事务，撤销之前的操作OGRDataSource::DestroyDataSource(poDS);delete poFeature;exit(1);}// 提交事务，保存更改poDS->CommitTransaction();​

GetFIDColumn

virtual const char *GetFIDColumn()

此方法返回用作 FID 列的基础数据库列的名称，如果不支持，则返回  ""

返回:  FID 列名称

    // 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 获取用于唯一标识要素的字段的名称const char* fid_column = poLayer->GetFIDColumn();if (fid_column != nullptr) {printf("用于唯一标识要素的字段名称：%s\n", fid_column);} else {printf("图层中没有用于唯一标识要素的字段。\n");}

GetGeometryColumn

virtual const char *GetGeometryColumn()

此方法返回用作几何列的基础数据库列的名称，如果不支持，则返回 “”

对于具有多个几何字段的图层，此方法仅返回第一个几何列的名称

返回: 几何列名称

    // 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 获取存储几何信息的字段的名称const char* geometry_column = poLayer->GetGeometryColumn();if (geometry_column != nullptr) {printf("存储几何信息的字段名称：%s\n", geometry_column);} else {printf("图层中没有存储几何信息的字段。\n");}

SetIgnoredFields

virtual OGRErr SetIgnoredFields（const char **papszFields)

设置从图层检索要素时可以省略的字段

参数:

papszFields -- 以 NULL 项结尾的字段名称数组。如果传递 NULL，则清除忽略的列表。

返回:  OGRERR_NONE是否已解析所有字段名称（即使驱动程序不支持此方法）

   // 获取第一个图层OGRLayer* poLayer = poDS->GetLayer(0);// 定义要忽略的字段数组const char* papszFields[] = {"field1", "field2"};// 设置要忽略的字段OGRErr err = poLayer->SetIgnoredFields(papszFields);if (err != OGRERR_NONE) {// 处理设置忽略字段时发生的错误}// 其他处理代码...

 GetIgnoredFields可以拿到忽略字段列表

    // 获取当前设置的忽略字段列表char** papszIgnoredFields = poLayer->GetIgnoredFields();// 打印忽略字段列表for (int i = 0; papszIgnoredFields[i] != nullptr; i++) {printf("Ignored Field: %s\n", papszIgnoredFields[i]);}

GetGeometryTypes

virtual OGRGeometryTypeCounter *GetGeometryTypes（int iGeomField， int nFlagsGGT， int &nEntryCountOut， GDALProgressFunc pfnProgress， void *pProgressData)

获取在要素中找到的实际几何类型

参数:

• iGeomField -- 几何字段索引。

• nFlagsGGT -- 提示标志。0 或 OGR_GGT_COUNT_NOT_NEEDED、OGR_GGT_STOP_IF_MIXED、OGR_GGT_GEOMCOLLECTIONZ_TINZ的组合

• nEntryCountOut -- [out] 返回数组中的条目数。

• pfnProgress-- 取消回调。可能为空。

• pProgressData -- 取消回调的用户数据。可能为空。

返回: 一个 nEntryCount 数组，如果出现错误，必须使用 CPLFree（） 或 NULL 释放

Intersection

OGRErr Intersection（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions = nullptr， GDALProgressFunc pfnProgress = nullptr， void *pProgressArg = nullptr)

两层的交集

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回:

如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

Union

OGRErr Union（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions = nullptr， GDALProgressFunc pfnProgress = nullptr， void *pProgressArg = nullptr)

两层并集

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回:

如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Union(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();

SymDifference

OGRErr SymDifference（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions， GDALProgressFunc pfnProgress， void *pProgressArg)

两层对称差异（交集取反）

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回:

如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->SymDifference(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();

Identity

OGRErr Identity（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions = nullptr， GDALProgressFunc pfnProgress = nullptr， void *pProgressArg = nullptr)

将此图层的特征与标识层中的特征标识

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回:

如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("Identity_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的恒等并将结果写入输出图层
OGRErr err = pLayer1->Identity(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();

Update

OGRErr Update（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions = nullptr， GDALProgressFunc pfnProgress = nullptr， void *pProgressArg = nullptr)

使用更新图层中的要素更新此图层

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回:

如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Update(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();

Clip

OGRErr Clip（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions = nullptr， GDALProgressFunc pfnProgress = nullptr， void *pProgressArg = nullptr)

裁剪方法图层未覆盖的区域

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回:如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Clip(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();

Erase

OGRErr Erase（OGRLayer *pLayerMethod， OGRLayer *pLayerResult， char **papszOptions = nullptr， GDALProgressFunc pfnProgress = nullptr， void *pProgressArg = nullptr)

移除方法图层覆盖的区域

参数:

• pLayerMethod -- 方法层。不应为 NULL。

• pLayerResult -- 插入操作生成的要素的图层。不应为 NULL。

• papszOptions -- NULL 终止的选项列表（可能为 NULL）。

• pfnProgress -- 一个与 GDALProgressFunc（） 兼容的回调函数，用于报告进度或 NULL。

• pProgressArg -- 要传递给 pfnProgress 的参数。可能为空。

返回: 如果出现错误或执行中断，则为错误代码，否则OGRERR_NONE

// 获取输入图层和输出图层
OGRLayer* pLayer1 = poInputDS->GetLayer(0);
OGRLayer* pLayer2 = poInputDS->GetLayer(1);
OGRLayer* pLayerResult = poOutputDS->CreateLayer("SymDifference_Result", nullptr, wkbUnknown, nullptr);// 计算几何形状的对称差并将结果写入输出图层
OGRErr err = pLayer1->Erase(pLayer2, pLayerResult, nullptr, nullptr, nullptr);// 保存并关闭结果图层
pLayerResult->SyncToDisk();

Reference

int Reference()

递增图层引用计数

返回:递增后的引用计数

Dereference

int Dereference()

递减图层参考计数

返回:递减后的引用计数

ReorderField

OGRErr ReorderField（int iOldFieldPos， int iNewFieldPos)

对图层上的现有字段重新排序

参数:

• iOldFieldPos -- 要移动的字段的先前位置。必须在 [0，GetFieldCount（）-1] 范围内。

• iNewFieldPos -- 要移动的字段的新位置。必须在 [0，GetFieldCount（）-1] 范围内。

返回:  OGRERR_NONE成功

// 获取输入图层
OGRLayer* pLayer = poInputDS->GetLayer(0);// 获取字段总数
int fieldCount = pLayer->GetLayerDefn()->GetFieldCount();// 假设我们要将第1个字段移动到第3个位置
int oldFieldPos = 0; // 第1个字段的位置（索引从0开始）
int newFieldPos = 2; // 新的位置（索引从0开始）if (oldFieldPos < 0 || oldFieldPos >= fieldCount || newFieldPos < 0 || newFieldPos >= fieldCount) {// 检查字段位置是否有效// 可以根据需要添加其他错误处理逻辑return OGRERR_FAILURE;
}// 重新排列字段
OGRErr err = pLayer->ReorderField(oldFieldPos, newFieldPos);
if (err != OGRERR_NONE) {// 重新排列失败，可以根据需要添加错误处理逻辑return err;
}// 保存并关闭数据源
pLayer->SyncToDisk();