大将电子研发管理软件编写规范（C）文件编号MI-RD-16版本A0生效日期07-8-1第页软件编写规范（C）文件结构每个C程式通常分为两个文件：用于保存程式的声明（declaration），称为头文件；用于保存程序的实现（implementation），称为定义（definition）文件。1．1版权和版本声明版权和版本声明位于头文件与定义文件的开头，主要内容有：版权信息。文件名称。当前版本号，作者/修改者，完成日期。历史信息/**Copyright(c)PremierElectronicDevelopmentCorp.2007*Filename.h/c*Version：1.1*Author：xxxxx*Date：2007-4-29*Update：*/1．2头文件的结构头文件由三部分内容组成：（1）头文件开头处的版权和版本声明。（2）预处理块。（3）函数和结构声明等【1-2-1】为了防止头文件被重复引用，应当用ifndef/define/endif结构产生预处理块；【1-2-2】用#include<filename.h>格式来引用标准库的头文件（编译器将从标准库目录开始搜索）；【1-2-3】用#include“filename.h”格式来引用非标准库的头文件（编译器将从用户的工作目录开始搜索）；#ifndef_XXXXX_H#define_XXXXX_H#include<math.h>#include“myhead.h”VoidFunction1(void);typedefstruct{…}ModeTableType;1．3定义文件的结构定义文件有三部分内容：（1）定义文件开头处的版权和版本声明。（2）对一些头文件的引用。（3）程序的实现体（包括数据和代码）。#include“xxxx.h”voidFunction1(void){…}1．4目录结构如果一个程式的文件较多，应该按照群组保存于不同的目录中（可以是多级目录）。如：Tuner目录下保存Tuner.c/Tuner.h。程序版式程序的版式不会影响程式的功能实现，但是会影响可读性，进而可能影响到今后的维护性。2．1空行空行起着分隔程序段落的作用。空行得体（不过多也不过少）将使程序的布局更加清晰。【2-1-1】在每个声明之后、每个函数定义结束之后都要加空行；//空行voidFunction1(void){…}//空行voidFunction2（void）{…}【2-1-2】在一个函数体内，逻揖上密切相关的语句之间不加空行，其它地方应加空行分隔；while(condition){Statement1;//空行if(condition){Statement2;}else{Statement3;}//空行Statement4;}2．2代码行【2-2-1】一行代码只做一件事情，如只定义一个变量，或只写一条语句。这样的代码容易阅读，并且方便于写注释；【2-2-2】尽可能在定义变量的同时初始化该变量（就近原则）；一直以来都是这样，喜欢一样东西，深入骨髓的，一直一直听玖哲《想太多》，12：30----13：30，想太多单曲循环千千静听的风播放清单里永远只会有一首歌。固定的时间/固定的音乐，熟练到一切都变成了无意识。仿若当初听《童话》时的固执。公共考终于完成了，这两天的状态很好，很放松。27号那天跟大头早早交了卷，带点兴奋的到处转攸，不知不觉差点把整个南头转完了，满街的小吃，喧嚣街道，各家服装商场的疯狂或者淡雅的音乐。难得的好心情跑去那个婚纱宣传活动参加现场。婚纱顾问那个姐姐人很好，陪着我们聊了很久，回答了我们一大堆的白痴问题。unsignedcharCounter=0；unsignedchartemp=255;【2-2-3】if、for、while、do等语句自占一行，执行语句不得紧跟其后。不论执行语句有多少都要加{}。这样可以防止书写失误。if(condition){dosomething;}2．3代码行中的空格【2-3-1】if、for、while等关键字之后应留一个空格再跟左括号‘（’，以突出关键字；if(condition){dosomething;}for(condition1;condition2;condition3){dosomething;}【2-3-2】函数名之后不要留空格，紧跟左括号‘（’，以与关键字区别；voidFunction(void)