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();
}

有以下几点需要注意:

  1. uriUnescapeInPlaceA只解码%开头的字符,+字符或者换行编码需要自己处理或者使用其他API。
  2. uriUnescapeInPlaceA不用考虑资源释放的问题,因为是在自身的资源空间处理的,解码的字符串长度只会缩短,所以资源空间够用,不用额外申请。
  3. 尝试过直接在std::string管理的字符串空间进行修改,也可以得到正常的结果且效率更高。不过chatgpt的回答表示这样不太安全,就还是多申请了一段空间std::vector<char> buffer来进行处理。