CMake构建学习笔记17-uriparser库的构建和使用
在连续论述了几篇关于CMake如何使用的文章之后,笔者也是感觉被掏空了。接下来几篇就还是回到构建依赖库的问题上,容笔者花时间找到更好的主题来介绍更多关于CMake使用干货。如何有的读者自信已经很熟悉这方面的知识,可以进行跳过,在需要的时候再进行查阅。
uriparser是一个严格遵循RFC 3986的URI解析和处理库,使用C89(“ANSI C”)编写。笔者认为在构建上uriparser这个库非常不错,在主页上就已经提供了CMake项目的引入示例和可用的CMake构建选项,大家可以参考一下。不得不说,要是所有的第三方库的文档都写的这么清楚那就世界和平了。
好了不废话了,直接给出构建的关键指令如下所示:
# 配置CMake
cmake .. -G "$Generator" -A x64 `
-DCMAKE_BUILD_TYPE=RelWithDebInfo `
-DCMAKE_INSTALL_PREFIX="$InstallDir" `
-DURIPARSER_BUILD_TESTS=OFF `
-DURIPARSER_BUILD_DOCS=OFF
# 构建阶段,指定构建类型
cmake --build . --config RelWithDebInfo
# 安装阶段,指定构建类型和安装目标
cmake --build . --config RelWithDebInfo --target install
另外笔者主要使用这个库对URI字符串进行解码,使用的函数如下所示:
std::string UriDecode(const std::string& encoded) {
// 创建一个可修改的字符缓冲区
std::vector<char> buffer(encoded.begin(), encoded.end());
buffer.push_back('\0'); // 确保以 '\0' 结尾
// 进行解码,uriUnescapeInPlaceA 解码数据时修改输入缓冲区
uriUnescapeInPlaceA(buffer.data());
return buffer.data();
}
有以下几点需要注意:
- uriUnescapeInPlaceA只解码%开头的字符,+字符或者换行编码需要自己处理或者使用其他API。
- uriUnescapeInPlaceA不用考虑资源释放的问题,因为是在自身的资源空间处理的,解码的字符串长度只会缩短,所以资源空间够用,不用额外申请。
- 尝试过直接在std::string管理的字符串空间进行修改,也可以得到正常的结果且效率更高。不过chatgpt的回答表示这样不太安全,就还是多申请了一段空间
std::vector<char> buffer
来进行处理。