高质量c++/c编程指南学习笔记(上)
时间:2002/11/13 pm 【程序编程相关:openssl之BIO系列之23---M】 【推荐阅读:基本形状开发】黎锦凡 【扩展信息:分析RSA算法演算过程及VB和C++的实】 «高质量c++/c编程指南»是 林锐 博士 写的,现在已经出书了.以下是我在学习中的一些笔记,贴给大家有空看看. 1. 关于版权与版本的声明 版权与版本的声明位于头文件与定义文件的开头.示例如下: /** copyright (c) 2001,上海贝尔有限公司网络应用事业部 * all rights reserved. * * 文件名称:filename.h * 文件标识:见配置管理计划书 * 摘 要:简要描述本文件的内容 * * 当前版本:1.1 * 作 者:输入作者(或修改者)名字 * 完成日期:2001年7月20日 * * 取代版本:1.0 * 原作者 :输入原作者(或修改者)名字 * 完成日期:2001年5月10日 */ 2. 关于头文件 ø 为了防止头文件被重复引用,应当用ifndef/define/endif结构产生预处理块. ø 头文件中只存放“声明”而不存放“定义”,包括内联函数最好也放在定义文件中. ø 尽可能少地使用全局变量,尽量不要在头文件中出现象extern int value 这类声明. 3. 源码文件的管理 如果一个软件的头文件数目比较多(如超过十个),通常应将头文件与定义文件分别保存于不同的目录,以便于维护. 例如可将头文件保存于include目录,将定义文件保存于source目录(可以是多级目录). 如果某些头文件是私有的,它不会被用户的程序直接引用,则没有必要公开其“声明”.为了加强信息隐藏,这些私有的头文件可以与定义文件存放于同一个目录. 4. 空行的作用 在每个类声明之后.每个函数定义结束之后都要加空行. 在一个函数体内,逻揖上密切相关的语句之间不加空行,其它地方应加空行分隔. 5. 代码行 ø 一行代码只做一件事情,如只定义一个变量,或只写一条语句.这样的代码容易阅读,并且方便于写注释. ø if.for.while.do等语句自占一行,执行语句不得紧跟其后.不论执行语句有多少都要加{}.这样可以防止书写失误. ø 尽可能在定义变量的同时初始化该变量 ... 下一页