|
第 1 章 文件结构
每个 C++/C 程序通常分为两个文件。一个文件用于保存程序的声明（ declaration ），称为头文件。另一个文件用于保存程序的实现（ implementation ），称为定义（ definition ）文件。
C++/C 程序的头文件以“ .h ”为后缀， C 程序的定义文件以“ .c ”为后缀， C++ 程序的定义文件通常以“ .cpp ”为后缀（也有一些系统以“ .cc ”或“ .cxx ”为后缀）。
1.1 版权和版本的声明
版权和版本的声明位于头文件和定义文件的开头（参见示例 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 。
l 【规则 1-2-1 】 为了防止头文件被重复引用，应当用 ifndef/define/endif 结构产生预处理块。
l 【规则 1-2-2 】 用 #include < filename.h> 格式来引用标准库的头文件（编译器将从标准库目录开始搜索）。
l 【规则 1-2-3 】 用 #include “filename.h” 格式来引用非标准库的头文件（编译器将从用户的工作目录开始搜索）。
2 【建议 1-2-1 】 头文件中只存放“声明”而不存放“定义”
在 C++ 语法中，类的成员函数可以在声明的同时被定义，并且自动成为内联函数。这虽然会带来书写上的方便，但却造成了风格不一致，弊大于利。建议将成员函数的定义与声明分开，不论该函数体有多么小。
[1] [2] 下一页
|
