如何在eclipse-cdt中自动生成函数头注释？答案

【问题标题】：How to automatically generate function header comments in eclipse-cdt?如何在eclipse-cdt中自动生成函数头注释？
【发布时间】：2013-01-07 17:48:29
【问题描述】：

有没有一种方法可以自动为 eclipse cdt 中的函数生成函数头？我看过相关帖子要求使用 Alt + Shift + J 或在函数标题前输入/** 并按 Enter。但是我想知道是否可以获得预定义的函数头。我试图在

中定义我的格式

C/C++ > 代码风格 > 代码模板 > 注释 > 方法

但找不到在代码中使用它的方法。

【问题讨论】：

你希望它们包含什么？
基本上任何我想要的信息......比如函数名称、作者、日期、参数、版权声明......等
带有氧气可以吸入的气味。
类似（不等于）未回答的问题：stackoverflow.com/questions/11592605/…
如果问题不够清楚或者是eclipse中的已知错误，请发表评论

标签： c++ c eclipse-cdt

【解决方案1】：

恐怕我只能部分回答你：

如果你去window -> preferences -> C/C++ -> Editor并在Documentation tool comments下选择Doxygen，输入/** + enter会在评论中填写参数并自动返回标签。我发现无法自动添加其他字段。
如果您转到windows -> preferences -> C/C++ -> Editor -> Templates，您将能够创建模板，当您输入模板名称时，eclipse 将能够自动完成。
例如，您可以创建一个名为“作者”的模板，将上下文设置为“文档评论”并将您需要的标签设置为模式。对于这个例子，我使用了@author ${user}（注意变量的使用）。现在您可以开始输入“aut”，按ctrl+space 自动完成，您的标签将被插入。

我知道这可能不是您正在寻找的答案，但它可能会有所帮助。我也一直在努力使用 Eclipse 设置来自动生成这些内容，但是您将在使用模板时会变得非常快，并且您可以更好地控制实际内容。

【讨论】：

【解决方案2】：

我找到了一些解决方法。

在首选项中创建模板 >> C/C++ >> 编辑器 >> 模板给出唯一的名称（如 comfun）像我一样使用变量 (${...}

保存模板

现在在函数声明中输入唯一名称并按 ctrl+space（注意没有标记文本），所以eclipse可以评估变量您所要做的就是将自动生成的文本移到函数上方。

希望对你有所帮助。

/*-----------------------------------------------------------------------------+
|    F U N C T I O N   I N F O R M A T I O N                                   |
+------------------------------------------------------------------------------+
|  ToDo: check auto generated function comment                           |
|                                                                              |
|  Function Name:  ${enclosing_method}                                     |
|                                                                              |
|  Prototype at:   ${file_base}_tdf.h                                   |
|                                                                              |
|  Description:    add some useful content                                     |
|                                                                              |
|                                                                              |
|  Parameter:      ${enclosing_method_arguments}         |
|                                                                              |
|  Return Value:   ${return_type} OK               |
|                                                                              |
+-----------------------------------------------------------------------------*/

【讨论】：