Layout conventions

Overview

　　和命名习惯一样，Symbian有一种标准的代码布局方式。开发者和组织一般都有自己偏爱的习惯。下面的信息是为了帮助你更好的阅读Symbian平台的代码，即使你已经打算采用其他的布局方式。

---

Headers

　　
• 尽量减少头文件的数目，尽可能使用前导声明。
  　　
• 使用标准的放重复机制，防止头文件的重复引用。例如：
  


　　// EG.H
　　//
　　// Copyright notice
　　//

　　#ifndef _EG_H_
　　#define _EG_H_
　　//...include files and declarations
　　#endif


---

Class layout

　　Symbian平台的类代码布局风格如下：

---

General

　　
• 为了可读性，永远保留访问控制标志
  　　
• 成员的声明顺序：公共成员函数、保护成员函数、私有成员函数、保护数据、私有数据、公共数据。相应的访问控制标志放在每一组的前面。
  　　
• 为了可读性，在声明中给出函数参数的名字。
  

---

Virtual functions

　　
• 在头文件里把替换继承的行为的虚函数都放在一起，用注释表明这些行为从哪一个类继承而来。
  　　
• 这些函数不写virtual关键字。
  　　
• 虚函数不能是inline函数，因为这样很难确定编译器会怎么处理它们。唯一例外的是虚inline析构器，这是被允许的。
  

---

Inline functions

　　
• 必须注明inline关键字。
  　　
• 不要在函数的声明里面实现inline函数。应该在头文件的底部实现，或者在其他文件实现。