按键盘上方向键 ← 或 → 可快速上下翻页,按键盘上的 Enter 键可回到本书目录页,按键盘上方向键 ↑ 可回到本页顶部!
————未阅读完?加入书签已便下次继续阅读!
:
2003…2008XXXXCorporation;AllRightsReserved。
*
ModuleName
:
DrawEngine/Display
*
*
CPU
:
ARM7
*
RTOS
:
Tron
*
*
CreateDate
:
2008/10/01
*
Author/Corporation
:
WhoAmI/yourpanyname
*
*
AbstractDescription
:
Placesomedescriptionhere。
*
*…RevisionHistory…
No
Version
Date
RevisedBy
Item
Description
*
1
V0。95
08。05。18
WhoAmI
abcdefghijklm
WhatUDo
*
************************************************************************/
【规则7…2】各个源文件必须有一个头文件说明,头文件各部分的书写顺序下:
No。
Item
1
Header
File
Header
Section
2
Multi…Include…Prevent
Section
3
Debug
Switch
Section
4
Include
File
Section
5
Macro
Define
Section
6
Structure
Define
Section
7
PrototypeDeclareSection
其中
Multi…Include…PreventSection是用来防止头文件被重复包含的。
如下例:
#ifndef
__FN_FILENAME_H
#define__FN_FILENAME_H
#endif
其中“FN_FILENAME”一般为本头文件名大写,这样可以有效避免重复,因为同一工程
中不可能存在两个同名的头文件。
/************************************************************************
*
FileName
:
FN_FileName。h
*
Copyright
:
2003…2008XXXXCorporation;AllRightsReserved。
*
ModuleName
:
DrawEngine/Display
*
*
CPU
:
ARM7
*
RTOS
:
Tron
*
*
CreateDate
:
2008/10/01
*
Author/Corporation
:
WhoAmI/yourpanyname
*
*
AbstractDescription
:
Placesomedescriptionhere。
*
*RevisionHistory…
No
Version
Date
RevisedBy
Item
Description
*
1
V0。95
08。05。18
WhoAmI
abcdefghijklm
WhatUDo
*
************************************************************************/
/************************************************************************
*
Multi…Include…PreventSection
************************************************************************/
#ifndef
__FN_FILENAME_H
#define
__FN_FILENAME_H
/************************************************************************
*
DebugswitchSection
************************************************************************/
#define
D_DISP_BASE
/************************************************************************
*
IncludeFileSection
************************************************************************/
#include
〃IncFile。h〃
/************************************************************************
*
MacroDefineSection
************************************************************************/
#define
MAX_TIMER_OUT
(4)
/************************************************************************
*
Struct
DefineSection
************************************************************************/
typedef
structCM_RadiationDose
{
unsignedcharucCtgID;
charcPatId_a'MAX_PATI_LEN';
}CM_RadiationDose_st;*CM_RadiationDose_pst;
/************************************************************************
*
PrototypeDeclareSection
************************************************************************/
unsignedintMD_guiGetScanTimes(void);
…
…
#endif
【规则7…3】源文件各部分的书写顺序如下:
No。
Item
1
Source
File
Header
Section
2
Debug
Switch
Section
3
Include
File
Section
4
Macro
Define
Section
5
Structure
Define
Section
6
Prototype
Declare
Section
7
Global
Variable
Declare
Section
8
File
Static
Variable
Define
Section
9
Function
Define
Section
/*************************************************************************
*
File
Name
:
FN_FileName。c
*
Copyright
:
2003…2008XXXXCorporation;AllRightsReserved。
*
ModuleName
:
DrawEngine/Display
*
*
CPU
:
ARM7
*
RTOS
:
Tron
*
*
CreateDate
:
2003/10/01
*
Author/Corporation
:
WhoAmI/yourpanyname
*
*
Abstract
Description
:
Place
some
description
here。
*
*…RevisionHistory…
No
Version
Date
Revised
By
Item
Description
*
1
V0。95
00。05。18
WhoAmI
abcdefghijklm
WhatUDo
*
************************************************************************/
/************************************************************************
*
DebugswitchSection
************************************************************************/
#define
D_DISP_BASE
/************************************************************************
*
Include
File
Section
************************************************************************/
#include
〃IncFile。h〃
/************************************************************************
*
MacroDefineSection
************************************************************************/
#define
MAX_TIMER_OUT
(4)
/************************************************************************
*
Struct
Define
Section
************************************************************************/
typedef
structCM_RadiationDose
{
unsignedchar
ucCtgID;
char
cPatId_a'MAX_PATI_LEN';
}CM_RadiationDose_st;
*pCM_RadiationDose_st;
/************************************************************************
*
PrototypeDeclareSection
************************************************************************/
unsigned
int
MD_guiGetScanTimes(void);
/************************************************************************
*
GlobalVariableDeclareSection
************************************************************************/
extern
unsigned
intMD_guiHoldBreathStatus;
/************************************************************************
*
File
Static
Variable
Define
Section
************************************************************************/
static
unsignedint
nuiNaviSysStatus;
/************************************************************************
*
Function
Define
Section
************************************************************************/
【规则7…4】需要对外公开的常量放在头文件中,不需要对外公开的常量放在定义文件
的头部。
7。2,文件名命名的规则
【规则7…5】文件标识符分为两部分,即文件名前缀和后缀。文件名前缀的最前面要使
用范围限定符——模块名(文件名)缩写;
【规则7…6】采用小写字母命名文件,避免使用一些比较通俗的文件名,如:public。c等。
16