asc-devkit/docs/zh/guide/technical_appendix/cpp_standard_support · yiming0671/asc-devkit

文件	最后提交记录	最后更新时间
cpp_language_feature	add cpp language feature docs Co-authored-by: wulinyu<wulinyu4@huawei.com> # message auto-generated for no-merge-commit merge: !6587 merge master into master add cpp language feature docs Created-by: wulinyu Commit-by: wulinyu Merged-by: cann-robot Description: ## 描述本PR新增Ascend C C++标准支持技术附录（技术附录> C++标准支持章节），系统化给出C/C++语言标准在Ascend C Device侧的支持情况与语法约束，替代原有内容单薄的`syntax_restrictions`三篇（features/functions/syntax_restrictions）。 ### 文档新增 \| 文档 \| 内容 \| \| --- \| --- \| \| overview.md（扩充） \| 语言标准选择方式（`-std`/`CMAKE_ASC_STANDARD`）、Host侧（与clang15一致）与Device侧（C++11/14/17/20四档、默认C++17）能力边界、章节导航 \| \| cpp_language_feature/cpp_language_feature.md \| Device侧C++语言支持总入口 \| \| cpp_language_feature/cpp11_language_feature.md \| C++11核心语言特性与C99收录特性的逐项支持列表（25项，附标准Proposal链接与注意事项） \| \| cpp_language_feature/cpp14_language_feature.md \| C++14特性逐项支持列表（7项） \| \| cpp_language_feature/cpp17_language_feature.md \| C++17特性逐项支持列表（16项） \| \| cpp_language_feature/lambda_expressions.md \| Lambda表达式专文：SIMT场景无需标记；混合编程场景的callee标记选择规则（`__simt_callee__`/`__simd_callee__`/`__aicore__`）、VF函数内Lambda能力清单、constexpr lambda使用约束 \| \| cpp_language_restrictions/general_restrictions.md \| 通用语法限制：不支持的特性清单、指针与内存地址（取Device函数地址/核函数地址/跨空间解引用）、变量（static/全局/const/volatile/constexpr表）、函数（核函数参数列表限制、SIMT VF函数限制、递归、可变参数）、类（成员函数标记、混合编程结构体限制）、模板（模板核函数、显式实例化） \| 所有结论均基于真实芯片逐项实测，报错信息为编译器原始输出。`docs/zh/guide/index.md`目录树同步更新，编程指南（SIMD/SIMT kernel_function、programming_examples）中指向旧章节的链接同步修正。 ### 样例新增（2个） \| 样例 \| 内容 \| \| --- \| --- \| \| examples/03_simt_api/02_features/02_language_features/00_lambda_operator_capture \| SIMT模式Lambda捕获实战：以LeakyReLU-Affine融合算子与Clamp算子为载体，演示值捕获携带超参、引用捕获累计统计、闭包组合表达融合算子、策略与框架分离四种实际编程用法 \| \| examples/05_simd_simt_hybrid/03_features/lambda_operator_hybrid \| 上述样例的混合编程对照实现：SIMT VF/SIMD VF/核函数体内Lambda分别按规则标记callee属性，SIMD侧演示"lambda标量逻辑+矢量intrinsics"数据流 \| 两个样例均含中英双语README、CMakeLists与完整可编译源码，与文档中Lambda标记规则互为引用。 ## 关联的Issue [#1884](https://gitcode.com/cann/asc-devkit/issues/1884) ## 测试 - 环境：Ascend 950PR真实芯片、dav-3510架构、CANN 9.3.0（bisheng clang 15.0.5）。 - 文档特性逐项实测：资料中全部特性结论按"特性在核函数内实际使用→结果写回GM→Host侧按独立复算期望值比对"的用例在真实NPU上验证，涵盖C++11/14/17特性清单、Lambda SIMT/混合编程标记规则、auto约束、别名模板约束、四执行空间（SIMT/SIMT VF/SIMD VF/MainScalar）语法限制矩阵。 - 约束触发取证：资料标注的编译失败类约束逐项触发并核对报错文案（如`reference to __host__ function`、`expecting parameter ... to have memory qualifier __gm__`、`recursive aicore function call is not allowed`等）。 - 示例工程上板验证：两个样例在真实NPU上编译运行，Host侧精度比对输出PASS（SIMT样例与混合编程样例均含自动化PASS/FAIL判定与返回码）。 ## 文档更新本PR全部改动均为文档与示例工程：新增技术附录8篇、示例工程2个（含中英README），更新目录索引与旧链接，删除被替代的`syntax_restrictions`三篇。 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6587	8 天前
cpp_language_restrictions	C++语法资料优化指针运算与字节重解释章节引导句 Co-authored-by: wulinyu<wulinyu4@huawei.com> # message auto-generated for no-merge-commit merge: !6995 merge fix/pointer-reinterpret-sentence into master C++语法资料优化指针运算与字节重解释章节引导句 Created-by: wulinyu Commit-by: wulinyu Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> C++语法资料优化指针运算与字节重解释章节引导句 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1884 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 资料规范自测通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6995	3 天前
cpp_standard_support.md	add cpp language feature docs Co-authored-by: wulinyu<wulinyu4@huawei.com> # message auto-generated for no-merge-commit merge: !6587 merge master into master add cpp language feature docs Created-by: wulinyu Commit-by: wulinyu Merged-by: cann-robot Description: ## 描述本PR新增Ascend C C++标准支持技术附录（技术附录> C++标准支持章节），系统化给出C/C++语言标准在Ascend C Device侧的支持情况与语法约束，替代原有内容单薄的`syntax_restrictions`三篇（features/functions/syntax_restrictions）。 ### 文档新增 \| 文档 \| 内容 \| \| --- \| --- \| \| overview.md（扩充） \| 语言标准选择方式（`-std`/`CMAKE_ASC_STANDARD`）、Host侧（与clang15一致）与Device侧（C++11/14/17/20四档、默认C++17）能力边界、章节导航 \| \| cpp_language_feature/cpp_language_feature.md \| Device侧C++语言支持总入口 \| \| cpp_language_feature/cpp11_language_feature.md \| C++11核心语言特性与C99收录特性的逐项支持列表（25项，附标准Proposal链接与注意事项） \| \| cpp_language_feature/cpp14_language_feature.md \| C++14特性逐项支持列表（7项） \| \| cpp_language_feature/cpp17_language_feature.md \| C++17特性逐项支持列表（16项） \| \| cpp_language_feature/lambda_expressions.md \| Lambda表达式专文：SIMT场景无需标记；混合编程场景的callee标记选择规则（`__simt_callee__`/`__simd_callee__`/`__aicore__`）、VF函数内Lambda能力清单、constexpr lambda使用约束 \| \| cpp_language_restrictions/general_restrictions.md \| 通用语法限制：不支持的特性清单、指针与内存地址（取Device函数地址/核函数地址/跨空间解引用）、变量（static/全局/const/volatile/constexpr表）、函数（核函数参数列表限制、SIMT VF函数限制、递归、可变参数）、类（成员函数标记、混合编程结构体限制）、模板（模板核函数、显式实例化） \| 所有结论均基于真实芯片逐项实测，报错信息为编译器原始输出。`docs/zh/guide/index.md`目录树同步更新，编程指南（SIMD/SIMT kernel_function、programming_examples）中指向旧章节的链接同步修正。 ### 样例新增（2个） \| 样例 \| 内容 \| \| --- \| --- \| \| examples/03_simt_api/02_features/02_language_features/00_lambda_operator_capture \| SIMT模式Lambda捕获实战：以LeakyReLU-Affine融合算子与Clamp算子为载体，演示值捕获携带超参、引用捕获累计统计、闭包组合表达融合算子、策略与框架分离四种实际编程用法 \| \| examples/05_simd_simt_hybrid/03_features/lambda_operator_hybrid \| 上述样例的混合编程对照实现：SIMT VF/SIMD VF/核函数体内Lambda分别按规则标记callee属性，SIMD侧演示"lambda标量逻辑+矢量intrinsics"数据流 \| 两个样例均含中英双语README、CMakeLists与完整可编译源码，与文档中Lambda标记规则互为引用。 ## 关联的Issue [#1884](https://gitcode.com/cann/asc-devkit/issues/1884) ## 测试 - 环境：Ascend 950PR真实芯片、dav-3510架构、CANN 9.3.0（bisheng clang 15.0.5）。 - 文档特性逐项实测：资料中全部特性结论按"特性在核函数内实际使用→结果写回GM→Host侧按独立复算期望值比对"的用例在真实NPU上验证，涵盖C++11/14/17特性清单、Lambda SIMT/混合编程标记规则、auto约束、别名模板约束、四执行空间（SIMT/SIMT VF/SIMD VF/MainScalar）语法限制矩阵。 - 约束触发取证：资料标注的编译失败类约束逐项触发并核对报错文案（如`reference to __host__ function`、`expecting parameter ... to have memory qualifier __gm__`、`recursive aicore function call is not allowed`等）。 - 示例工程上板验证：两个样例在真实NPU上编译运行，Host侧精度比对输出PASS（SIMT样例与混合编程样例均含自动化PASS/FAIL判定与返回码）。 ## 文档更新本PR全部改动均为文档与示例工程：新增技术附录8篇、示例工程2个（含中英README），更新目录索引与旧链接，删除被替代的`syntax_restrictions`三篇。 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6587	8 天前
overview.md	add cpp language feature docs Co-authored-by: wulinyu<wulinyu4@huawei.com> # message auto-generated for no-merge-commit merge: !6587 merge master into master add cpp language feature docs Created-by: wulinyu Commit-by: wulinyu Merged-by: cann-robot Description: ## 描述本PR新增Ascend C C++标准支持技术附录（技术附录> C++标准支持章节），系统化给出C/C++语言标准在Ascend C Device侧的支持情况与语法约束，替代原有内容单薄的`syntax_restrictions`三篇（features/functions/syntax_restrictions）。 ### 文档新增 \| 文档 \| 内容 \| \| --- \| --- \| \| overview.md（扩充） \| 语言标准选择方式（`-std`/`CMAKE_ASC_STANDARD`）、Host侧（与clang15一致）与Device侧（C++11/14/17/20四档、默认C++17）能力边界、章节导航 \| \| cpp_language_feature/cpp_language_feature.md \| Device侧C++语言支持总入口 \| \| cpp_language_feature/cpp11_language_feature.md \| C++11核心语言特性与C99收录特性的逐项支持列表（25项，附标准Proposal链接与注意事项） \| \| cpp_language_feature/cpp14_language_feature.md \| C++14特性逐项支持列表（7项） \| \| cpp_language_feature/cpp17_language_feature.md \| C++17特性逐项支持列表（16项） \| \| cpp_language_feature/lambda_expressions.md \| Lambda表达式专文：SIMT场景无需标记；混合编程场景的callee标记选择规则（`__simt_callee__`/`__simd_callee__`/`__aicore__`）、VF函数内Lambda能力清单、constexpr lambda使用约束 \| \| cpp_language_restrictions/general_restrictions.md \| 通用语法限制：不支持的特性清单、指针与内存地址（取Device函数地址/核函数地址/跨空间解引用）、变量（static/全局/const/volatile/constexpr表）、函数（核函数参数列表限制、SIMT VF函数限制、递归、可变参数）、类（成员函数标记、混合编程结构体限制）、模板（模板核函数、显式实例化） \| 所有结论均基于真实芯片逐项实测，报错信息为编译器原始输出。`docs/zh/guide/index.md`目录树同步更新，编程指南（SIMD/SIMT kernel_function、programming_examples）中指向旧章节的链接同步修正。 ### 样例新增（2个） \| 样例 \| 内容 \| \| --- \| --- \| \| examples/03_simt_api/02_features/02_language_features/00_lambda_operator_capture \| SIMT模式Lambda捕获实战：以LeakyReLU-Affine融合算子与Clamp算子为载体，演示值捕获携带超参、引用捕获累计统计、闭包组合表达融合算子、策略与框架分离四种实际编程用法 \| \| examples/05_simd_simt_hybrid/03_features/lambda_operator_hybrid \| 上述样例的混合编程对照实现：SIMT VF/SIMD VF/核函数体内Lambda分别按规则标记callee属性，SIMD侧演示"lambda标量逻辑+矢量intrinsics"数据流 \| 两个样例均含中英双语README、CMakeLists与完整可编译源码，与文档中Lambda标记规则互为引用。 ## 关联的Issue [#1884](https://gitcode.com/cann/asc-devkit/issues/1884) ## 测试 - 环境：Ascend 950PR真实芯片、dav-3510架构、CANN 9.3.0（bisheng clang 15.0.5）。 - 文档特性逐项实测：资料中全部特性结论按"特性在核函数内实际使用→结果写回GM→Host侧按独立复算期望值比对"的用例在真实NPU上验证，涵盖C++11/14/17特性清单、Lambda SIMT/混合编程标记规则、auto约束、别名模板约束、四执行空间（SIMT/SIMT VF/SIMD VF/MainScalar）语法限制矩阵。 - 约束触发取证：资料标注的编译失败类约束逐项触发并核对报错文案（如`reference to __host__ function`、`expecting parameter ... to have memory qualifier __gm__`、`recursive aicore function call is not allowed`等）。 - 示例工程上板验证：两个样例在真实NPU上编译运行，Host侧精度比对输出PASS（SIMT样例与混合编程样例均含自动化PASS/FAIL判定与返回码）。 ## 文档更新本PR全部改动均为文档与示例工程：新增技术附录8篇、示例工程2个（含中英README），更新目录索引与旧链接，删除被替代的`syntax_restrictions`三篇。 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6587	8 天前