Qt Creator中变量与函数的注释 - 鼠标悬浮可显示

Qt Creator中变量与函数的注释 - 鼠标悬浮可显示

引言

代码注释在软件开发中起着至关重要的作用。它们不仅有助于开发者理解和维护代码,还能促进团队协作,提高代码的可读性和可维护性。适当的注释应该是简洁明了、有针对性的,能够真正帮助其他开发者以及未来的自己理解和使用代码。

本文主要针对c++类中的变量和函数. 鼠标悬浮或写代码时有相关注释提示。

一、变量注释

对类中的变量进行注释:

    1. 效果展示 (鼠标悬浮在相应变量即可显示注释,写代码时代码补全也会提示):

    1. 源码 (注释方式)
      一般都使用/////进行单行注释,使用/* */进行多行注释. 但是在Qt Creator中使用以上注释方式没有相关提示。
      使用///<进行单行注释,使用/** */进行多行注释,则鼠标悬浮会显示相应的注释。
cpp 复制代码
    int m_int; ///< 一个普通的int变量
    double m_doubel; /**< 一个普通的double变量 */
    /**
     * @brief 一个普通的float变量
     */
    float m_float;

二、函数注释

对类中的函数进行注释:

    1. 效果展示 (简单举了两个例子)
    1. 源码 (注释方式)
      常用的是/** */以及@brief说明函数作用,输入/**回车即可自动补全。
      (还可以使用/*!//!///以及\brief等,有多种注释 (函数上方)只会显示离函数最近的一个)
cpp 复制代码
    /**
     * @brief a
     */
    void a();

    /*!
     * \brief b
     */
    void b();

    //!
    //! \brief c
    //!
    void c();
    
    /// d
    /// dd
    /// ddd
    void d();
    1. 常用的注释规范
@项 描述
@brief 函数简介 (鼠标悬浮会显示)
@param 参数介绍
@return 函数返回介绍
@author 作者简介
@version 版本说明
@data 创建 or 修改时间
@exception 异常说明
@... ...
    1. 还可以在文本编辑器设置:自定义自动给函数生成注释模版

Qt Creator自动给函数生成注释模板:https://blog.csdn.net/qq_21449473/article/details/118223381

三、参考链接

Qt Creator中一些常用小技巧(总结):https://blog.csdn.net/Littlehero_121/article/details/105784118

Qt Creator 关于变量注释的正确写法:https://blog.csdn.net/becklee2011/article/details/116784871

QtCreator中自动补全注释:https://blog.csdn.net/u010168781/article/details/87725403

在 Qt Creator 中编写 Doxygen 风格的注释:https://blog.csdn.net/m0_61629312/article/details/134905164

C++与Doxygen:精通代码文档化之道:https://blog.csdn.net/qq_21438461/article/details/135072700

相关推荐
阿桂天山4 分钟前
实现批量图片文字识别(python+flask+EasyOCR)
开发语言·python·flask
天天进步201510 分钟前
Python跨平台桌面应用程序开发
开发语言·python
时光话19 分钟前
Lua 第9部分 闭包
开发语言·lua
时光话19 分钟前
Lua 第7部分 输入输出
开发语言·lua
海上彼尚24 分钟前
使用Autocannon.js进行HTTP压测
开发语言·javascript·http
勇敢牛牛@25 分钟前
Python flask入门
开发语言·python·flask
万水千山走遍TML44 分钟前
JavaScript性能优化
开发语言·前端·javascript·性能优化·js·js性能
三体世界2 小时前
Linux 管道理解
linux·c语言·开发语言·c++·git·vscode·visual studio
我命由我123452 小时前
Android Cordova 开发 - Cordova 快速入门(Cordova 环境配置、Cordova 第一个应用程序)
android·开发语言·前端框架·android studio·h5·安卓·android-studio
Mikey_n2 小时前
深入理解依赖、Jar 包与 War 包:Java 开发基石探秘
java·开发语言·jar