注释C/C++代码

Question

最近,我掌握了Microsoft的标准注释语言(SAL),用于注释C/C++源代码.此功能对于调试和开发过程非常有用,但不幸的是它不是一个可移植的跨平台库.是否有用于注释C/C++代码的标准或开源工具？gcc中是否有类似的功能？

Answer 1

我所知道的最接近的是GCC的属性,但其他编译器不支持语法.GCC属性语法不支持与SAL一样多的注释,但您可能会发现一些注释很有用.

或者,如果您正在使用模板,则可能需要查看大多数编译器支持的Boost Static Assert.

另请注意,CLANG支持比GCC更多的注释,并且使用CLANG的静态分析器可能更接近您想要的.

还有一个想法-可能只需要SAL扩展就可以在MSVC上工作，而在其他编译器下，您基本上不添加注释。您只能在Windows平台上运行静态分析器，但至少它仍可以使用其他编译器在其他平台上进行编译。我已经出于其他原因执行了此操作-gcc比msvc更具兼容性，因此我通常在gcc上进行编译以确保我正在编写标准代码，但是msvc具有更好的错误消息，尤其是在模板错误方面，因此我使用msvc当我遇到编译器错误时，我无法破解。 (2认同)