2004-01-30

Symbian OS开发日记(Essential Idioms-Layout conventions)

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函数。应该在头文件的底部实现,或者在其他文件实现。

请不要吝惜您的评论,每一条评论,都是我在漫漫长夜前行的力量

0 条评论:

发表评论

<< 主页