已弃用的 API#

NVPL Sparse 库文档明确指出了一组已弃用的 API/枚举器/数据结构。库关于已弃用 API 的策略如下：

  1. API 在 X.Y 版本（例如 1.5）上被标记为 [[DEPRECATED]]

    • 文档会索引可用的替代项（如果有）

    • 否则，该功能在未来将不再维护

  2. API 将在 X+1.0 版本（例如 1.8）中移除

即使对于已弃用的 API，仍然会解决正确性错误，但不总是确保性能问题。

除了文档之外，已弃用的 API 在使用时还会为大多数平台生成编译时警告。可以通过在包含 nvpl_sparse.h 之前定义宏 DISABLE_NVPL_SPARSE_DEPRECATED 或将标志 -DDISABLE_NVPL_SPARSE_DEPRECATED 传递给编译器来禁用弃用警告。