C++ API 参考¶ SparQ C++ 框架的 API 参考。本节内容抽取自源码头文件中的中文 Doxygen 注释， 由 Doxygen 生成 XML 后经 Breathe 渲染，与源码保持同步。 备注 Python 侧（pysparq）的 API 参考请见 API 参考； 算子的使用讲解与示例请见 算子参考。 核心组件与量子门 基础组件（SparQ/include/basic_components.h） 基础量子门（SparQ/include/basic_gates.h） 整数寄存器 Hadamard（SparQ/include/hadamard.h） 量子傅里叶变换（SparQ/include/qft.h） 一般旋转与态制备（SparQ/include/rot.h） 条件旋转（SparQ/include/condrot.h） 干涉基组件（SparQ/include/quantum_interfere_basic.h） 测量与读出 中间电路测量（SparQ/include/measurement.h） 部分迹与读出（SparQ/include/partial_trace.h） QRAM 操作 量子随机存取存储器（SparQ/include/qram.h） 量子算术与状态整理 量子算术（SparQ/include/quantum_arithmetic.h） 并行相位操作（SparQ/include/parallel_phase_operations.h） 状态排序（SparQ/include/sort_state.h） 暗魔法算子（SparQ/include/dark_magic.h） 寄存器/系统操作与调试 寄存器生命周期操作（SparQ/include/system_operations.h） 调试与校验算子（SparQ/include/debugger.h） 全局宏（SparQ/include/global_macros.h） 算法库（顶层） Grover 搜索（SparQ_Algorithm/include/grover.h） Shor 因数分解（SparQ_Algorithm/include/shor.h） 态制备（SparQ_Algorithm/include/state_preparation.h） 块编码总览（SparQ_Algorithm/include/block_encoding.h） 哈密顿量模拟（SparQ_Algorithm/include/hamiltonian_simulation.h） 块编码（BlockEncoding/） 三对角矩阵块编码（SparQ_Algorithm/include/BlockEncoding/block_encoding_tridiagonal.h） 基于 QRAM 的块编码（SparQ_Algorithm/include/BlockEncoding/block_encoding_via_QRAM.h） QRAM 构造工具（SparQ_Algorithm/include/BlockEncoding/make_qram.h） 离散绝热（DiscreteAdiabatic/） QDA 基础组件（SparQ_Algorithm/include/DiscreteAdiabatic/qda_fundamental.h） 三对角 QDA 求解器（SparQ_Algorithm/include/DiscreteAdiabatic/qda_tridiagonal.h） 基于 QRAM 的 QDA 求解器（SparQ_Algorithm/include/DiscreteAdiabatic/qda_via_QRAM.h） CUDA 后端 GPU 基础组件（SparQ/include/cuda/basic_components.cuh） GPU 条件旋转（SparQ/include/cuda/condrot.cuh） GPU 干涉基组件（SparQ/include/cuda/quantum_interfere_basic.cuh） GPU 稀疏态模拟器入口（SparQ/include/cuda/sparse_state_simulator.cuh） Python 绑定层（C++ 侧） pybind11 绑定入口（PySparQ/core.cpp 生成的 pysparq._core 模块） 绑定辅助宏（PySparQ/include/BindUtils.h） 动态算子加载器（PySparQ/pysparq/dynamic_operator/include/dynamic_operator_loader.h）