STM32中的一些头文件中,总有类似的一段程序,如: ⼀** @addtogroup CMSIS * @{ *⼀这个是什么?

2025-04-14 04:55:24
推荐回答(4个)
回答(1):

这个是注释啊。。。中文是 :添加到组CMSIS

回答(2):

这个不需要关心,只是说明这个文件的作者,公司产品等等,你贴出来的估计是小小的广而告之,这也是程序员的一点小小的特权嘛

回答(3):

嗯!这个是对本段程序的一个说明!简单的介绍一下这段程序的功能和相关的参数的类型和设置!!

回答(4):

/** * @addtogroup CMSIS */    /*@{*/    /*@}*/

这些是doxygen的特定指令,以@或者\开头,上面三个一般是组合使用,意思是将{ }里面的内容加入到组CMSIS中,并且@addtogroup指令后面的组,如果没有就创建,有就加入,不会像@defgroup一样因为多次使用相同的组名,重复定义而收到警告。

Doxygen主页:www.doxygen.nl网页链接

Doxygen百度百科:网页链接

Doxygen是一种开源跨平台的,以类似JavaDoc风格描述的文档系统;是一个程序的文件产生工具,可将程序中的特定注释转换成为说明文件。

程序员在编写代码的时候,为了方便自己或者他人日后维护或者再利用,通常都会写一下文件、函数及参数的相关注释。对于小的工程来说,阅读几行注释就可以理清程序的脉络。但是对于一些大的工程,一个文件就有成百上千行代码,工程又包含许多文件,这般庞大的工程,阅读每一个文件、每一个函数、每一个参数的注释来寻找需要的信息,绝对是让人头大的工作。使用Doxygen,利用特定的指令,则可以帮助程序设计师产出漂亮的说明文件,从而可以方便阅读。