Making Libraries Consumable for Non-C++ Developers

• 语言: 英语
• 格式: .pptx
• 来源: github.com/CppCon

摘要

文档讨论了如何让非C++开发者更好地使用C++库，重点介绍了调用约定、内存管理和数据类型等方面的注意事项。文档强调了明确调用约定、避免跨边界异常处理以及精确定义数据类型的重要性，并提到了不同平台和编译器在内存管理和数据类型上的差异。还提出了一些最佳实践，包括接受内存分配回调、限制隐式内存模型以及明确记录所有假设和详细信息。

AI总结

《Making Libraries Consumable for Non-C++ Developers》摘要：

本文探讨了如何让 C++ 库更容易被非 C++ 开发者使用，重点关注跨语言ABI可见性问题，并提出了解决方案。以下是核心内容：

1. **ABI可见性问题**
- 示例代码中，`DoTheThing`函数在 Windows 上成功，但在 Linux 上失败，主要由于调用约定（如 `stdcall` 或 `cdecl`）和内存清理责任（caller cleanup 或 callee cleanup）未明确。
- 未声明的内容可能导致问题，例如 `data_t` 结构体的内存分配和管理方式未明确。

2. **异常处理**
- C++ 异常没有通用的二进制约定，可能导致调用者未prepared，出现 undefined 行为。
- 不同编译器标志（如 `clang` 的 `-fsjlj-exceptions`）可能导致异常处理不一致。

3. **内存模型与线程亲和力**
- 内存管理规则需要明确，特别是在跨语言交互时，应避免内存绑定到特定线程。
- 建议接受分配/释放回调，以减少内存管理的复杂性。

4. **类型与编码**
- 使用精确类型（如 `int64_t` 或 `int32_t`）代替不明确的 `long` 或 `int`。
- 字符串编码需明确，避免因宽度差异（如 `sizeof(wchar_t)` 在 Windows 和非 Windows 上分别为 2 和 4）引发问题。

5. **调用约定与文档**
- 明确记录调用约定，定义宏（如 `MYLIB_CCONV`）以避免差异。
- 文档应清晰说明函数参数、内存规则和假设，避免隐含假设。

6. **跨语言交互方法**
- 包括 C 接口、COM、libffi、SWIG、JNI、P/Invoke、JNA 和 Swift 等，各有优劣。

结论：通过明确文档、精确类型和内存管理规则，C++ 库可以更好地支持跨语言交互。