首页 > 其他 > 详细

嵌入式 C 注释风格

时间:2017-05-07 12:13:30      阅读:222      评论:0      收藏:0      [点我收藏+]

注释

1. 文件注释

/**
******************************************************************************
* @file
* @author
* @version V1.0.0
* @date 2017-5-7 10:46:21
* @brief This file provides template for all peripherals interrupt service routine.
******************************************************************************
* @attention
*
******************************************************************************
*/

 

2. 函数注释

/**
* @brief Returns the selected Button state.
* @param Button: Specifies the Button to be checked.
* This parameter can be one of following parameters:
* @arg BUTTON_KEY: Key Push Button
* @arg BUTTON_RIGHT: Joystick Right Push Button
* @arg BUTTON_LEFT: Joystick Left Push Button
* @arg BUTTON_UP: Joystick Up Push Button
* @arg BUTTON_DOWN: Joystick Down Push Button
* @arg BUTTON_SEL: Joystick Sel Push Button
* @retval The Button GPIO pin value.
*/

 

3. 语句注释

/* ... */
注释放在代码前

变量命名

1. 全局变量

全局变量命令符合以下规则:

  • 全局变量加 g 前缀 eg: uint_t g_UserCount;
  • 静态全局变量加 s 前缀 eg: uint8_t s_EenterTimes;
  • 局部变量全部小写,用_分隔单词 eg: uint8_t tmp_val;

嵌入式 C 注释风格

原文:http://www.cnblogs.com/fengyang66/p/6820194.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!