C/C++使用GDAL库编程窍门之——通用可移植性库（Common Portability Library, CPL）

C/C++使用GDAL库编程窍门之——通用可移植性库（Common Portability Library, CPL）

CPL简介

GDAL全称地理空间数据抽象库（Geospatial Data Abstraction Library），是一个强大的地理栅格空间数据转换库，支持众多的栅格和矢量的地理空间数据格式，跨平台性好、提供C/C++、python等语言的API，简单易用。
CPL(Common Portability Library)，即通用可移植性库，是GDAL的组件之一，用于增强GDAL的可移植性。用户只需调用其中的函数而不需要针对不同平台去更改代码，例如创建文件夹、获取当前程序运行路径等。

常用功能总结

在代码中包含了gdal_priv.h和gdal_utils.h之后即可使用CPL大多数的函数：

CPLSetConfigOption("GDAL_FILENAME_IS_UTF8", "NO");/// 默认文件名字符串的编码是UTF-8不支持中文路径，设置此行代码后支持中文路径
char strDir[256];
CPLGetExecPath(strDir, 256);// 获取当前exe全路径
const char* path = CPLGetPath(strDir);// 从输入字符串提取（文件夹）路径，xxx\yyy.tif提取为xxx
string strInputImg;
cin>>strInputImg;
const char* pExtIn = CPLGetExtension(strInputImg.c_str());// 获取文件扩展名，不带'.'.
char strOutDir[256];
strcpy(strOutDir, "E:/new_dir/new_subdir");
VSIMkdirRecursive(strOutDir, 0755);// 递归地创建文件夹，即如果父文件夹不存在，亦创建之。第二个参数是文件夹访问权限，默认给0755即可。
VSIStatBufL stat;
if (VSIStatExL(strInputImg, &stat, VSI_STAT_EXISTS_FLAG)==-1)//VSIStatExL函数用于获取文件的状态信息，包括修改时间、文件大小等，获取失败时也即文件不存在，返回-1
{
    return;//如果文件不存在
    CPLprintf("File %s not exist.", strInputImg.c_str());// CPLprintf用法完全同printf
}
string strOutputImg;
cin>>strOutputImg;
CPLCopyFile(strOutputImg, strInputImg);//拷贝文件 注意第一个参数是新文件路径，第二个参数是原始文件路径

更多接口，也可查看GDAL库的include路径下以cpl_开头的多个头文件，如cpl_conv.h,cpl_port.h,cpl_vsi.h等。
更多用法，请参考中文文档。

PS: GDAL的功能过于强大，很多东西都需要从文档学习、自己大胆尝试、问Google。