zoukankan      html  css  js  c++  java
  • C语言编程规范概要

    编程规范概要

    1、 程序结构清析,简单易懂,单个函数的程序行数不得超过100行。

    2、 打算干什么,要简单,直截了当,代码精简,避免垃圾程序。

    3、 尽量使用标准库函数和公共函数。

    4、 不要随意定义全局变量,尽量使用局部变量。

    5、 使用括号以避免二义性。

    可读性要求

    1、可读性第一,效率第二。

    2、保持注释与代码完全一致。

    3、每个源程序文件,都有文件头说明,说明规格见规范。

    4、每个函数,都有函数头说明,说明规格见规范。

    5、主要变量(结构、联合、类或对象)定义或引用时,注释能反映其含义。

    6、常量定义(DEFINE)有相应说明。

    7、处理过程的每个阶段都有相关注释说明。

    8、在典型算法前都有注释。

    9、利用缩进来显示程序的逻辑结构,缩进量一致并以Tab键为单位(定义Tab为 6个字节)

    10、循环、分支层次不要超过五层。

    11、注释可以与语句在同一行,也可以在上行。

    12、空行和空白字符也是一种特殊注释。

    13、一目了然的语句不加注释。

    14、注释的作用范围可以为:定义、引用、条件分支以及一段代码。

    15、注释行数(不包括程序头和函数头说明部份)应占总行数的1/5 到 1/3 。

  • 相关阅读:
    STM32系列命名规则
    在使用MOS管时要注意的问题
    LED汽车前大灯
    Linux Makefile analysis for plain usr
    Linux Kernel Makefile Test
    linux源码Makefile的详细分析
    "The connection for the USB device '###' was unsuccessful. The device is currently in use"
    Allegro使用技巧
    Integrated Circuit Intro
    ADC/DAC的一些参数
  • 原文地址:https://www.cnblogs.com/mrsandstorm/p/5663446.html
Copyright © 2011-2022 走看看