程序风格的要素－C++风格指南

程序风格的要素－C++风格指南

原著：Neill Kipp
翻译：Panic
2005年3月30日

译者序：这是一篇写于1996年1月23日的文章，到现在已经有9个年头了，很陈旧，有可能跟不上形势，但是有些东西仍然值得现在的开发者学习，我翻译这篇文字仅供读者参考。

原文链接：http://www.gamedev.net/reference/articles/article708.asp

文件
　　头文件有".h"后缀。头文件包含类(class)，结构(struct)，和联合(union)的声明，枚举(enum)的声明，#define，typedef。
　　实现文件有一个".cc" (UNIX) 或者".cpp" (Windows, DOS)后缀。实现文件包括函数和方法的实现。
　　在头文件和源代码文件中安排一个页眉。页眉可以包含标题，作者，日期，和一些工程的信息，比如这个文件是配合整个工程的。

一些名字

通用C++字符的名字：
（注：这些都是符号的英文原名，目前并没有完全标准化的汉语词汇对应，所以后面的翻译只是个人建议）
{open brace, open curly 左花括号}close brace, close curly 右花括号(open parenthesis, open paren 左圆括号)close parenthesis, close paren 右圆括号[open bracket 左方括号]close bracket 右方括号.period, dot 句号，点!exclamation point, bang, not 叹号，否|bar, vertical-bar, or, or-bar (actually a "vertical virgule") 竖线，按位或&ampersand, and, reference, ref 和，按位与，引用，取地址*asterisk, multiply, star, pointer 星号，乘号，星，指针/slash, divide 斜线，除号//slash-slash, comment 双斜线，注释符#pound 井号 （宏：#，参考 把符号转化为字符串的宏技巧 ）backslash, (sometimes "escape") 反斜线，（有时候做转义符）（还有一个：续行符）~tilde 按位取反
基本类型 "char" 通常发音是"charcoal."的首音节。有时念作 "care" 或者 "car."

名字和排版

命名约定的名字 interspersed_underscores 中间下划线lowercaseMixedCapital 小写混合（首字母）大写；CapitalMixedCapital （首字母）大写混合（首字母）大写；ALL_UPPERCASE 全部大写

命名约定的应用

自成档代码（也就是没有文档，仅靠注释和代码说明的源代码文件）

避免直接使用数字(Magic number)

空白

空白和排版