读林锐博士 高质量C++/C编程指南 笔记 2006-11-15第一章文件结构
C++/C 程序通常分为两个文件:
1. 头文件:用于保存程序的声明(declaration),以“
.h”为后缀;
2. 定义(definition)文件:用于保存程序的实现(implementation),C 程序的定义文件以“.c”为后缀,
C++程序通常以“.cpp”为后缀。
1.1
版权和版本的声明
主要内容有:
(1)版权信息。
(2)文件名称,标识符,摘要。
(3)当前版本号,作者/修改者,完成日期。
(4)版本历史信息。
一个例子:
/*
|
* Copyright (c) 2001, 上海贝尔有限公司网络应用事业部
|
* All rights reserved.
|
*
|
* 文件名称:filename.h
|
* 文件标识:见配置管理计划书
|
* 摘 要:简要描述本文件的内容
|
*
|
* 当前版本:1.1
|
* 作 者:输入作者(或修改者)名字
|
* 完成日期:2001 年7 月20 日
|
*
|
* 取代版本:1.0
|
* 原作者 :输入原作者(或修改者)名字
|
* 完成日期:2001 年5 月10 日
|
*/
|
示例1-1 版权和版本的声明
|
1.2
头文件的结构
头文件由三部分内容组成:
(1)头文件开头处的版权和版本声明(参见示例1-1)。
(2)预处理块。
(3)函数和类结构声明等。
假设头文件名称为
graphics.h,头文件的结构参见示例1-2。