CMake构建学习笔记17-uriparser库的构建和使用

charlee442024-09-16 19:26

在连续论述了几篇关于CMake如何使用的文章之后，笔者也是感觉被掏空了。接下来几篇就还是回到构建依赖库的问题上，容笔者花时间找到更好的主题来介绍更多关于CMake使用干货。如何有的读者自信已经很熟悉这方面的知识，可以进行跳过，在需要的时候再进行查阅。

uriparser是一个严格遵循RFC 3986的URI解析和处理库，使用C89（"ANSI C"）编写。笔者认为在构建上uriparser这个库非常不错，在主页上就已经提供了CMake项目的引入示例和可用的CMake构建选项，大家可以参考一下。不得不说，要是所有的第三方库的文档都写的这么清楚那就世界和平了。

好了不废话了，直接给出构建的关键指令如下所示：

cpp 复制代码

# 配置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字符串进行解码，使用的函数如下所示：

cpp 复制代码

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来进行处理。