理解Symbian的命名规则

本文最初发表于SpriteLW的博客http://blog.csdn.net/SpriteLW，欢迎转载，但请务必保留原文完整，并保留本声明。 

 

前缀T、C、R、M

T ―― 数据类型，如Tint,Tuint,TReal，也包括typedef和enum

C ―― 派生天CBase类。

R ―― 资源类。如RFile类，RThread类

M ―― 接口类。M代表Mixin

 

后缀为“L”和“LC”的函数

       表示该函数有可能有“异常”抛出（L表示Leave，后面有讲解），可是这个异常不同C++的异常，是Symbian自己发明的异常。Symbian OS的异常退出/陷阱方法与C++的抛出/捕获方法相比，更轻量级，也更有效。

 

Symbian的异常处理机制

       以下是Symbian异常退出/陷阱示例：

void fooBarL()
{
       TInt rc;
       rc = SomeFunction();
       if(rc)
       {
              User::Leave(KAnError);//leave被调用
       }
       //如果Leave没有被调用，则运行以下代码
       ...
}
 
void MyFunctionL()
{
       ....
       fooBarL();
       //如果Leave没有在fooBarL()里被执行，则继续往下运行
       ...
}
 
void StartHere()
{
       TInt LeaveError;
      
       TRAP(LeaveError,MyFunctionL());
       if(LeaveError)
       {
              //处理错误
       }
       //继续运行
       ...
}

       程序从StartHere开始，通过TRAP宏调用MyFunctionL()，而 MyFunctionL()调用fooBarL()（没有TRAP宏）。如果在fooBarL中SomeFunction失败，则调用系统静态API函数 User::Leave()，这将使fooBarL即刻停止执行，并返回到MyFunctionL()，由于MyFunctionL()调用 fooBarL时，没有定义一个陷阱处理器（TRAP），则MyFunctionL调用fooBarL函数后立即退出，并向它的调用函数 StartHere传送异常。

       由于StartHere()使用TRAP宏调用MyFunctionL()，所以StartHere不会自动退出，相反，

异常退出码(KAnError)写入TRAP宏的第一个参数(LeaveError)，并继续运行。

 

TRAP宏和TRAPD宏

       TRAP宏的原型为TRAP(TInt,Function)，第一个参数必须在前面有定义，如

TInt LeaveError;
TRAP(LeaveError,MyFunctionL());

       如果MyFunctionL由于异常退出，则LeaveError就会被设置成传递给User::Leave()的值，如果没有发生异常，则LeaveError被设置为KErrNone(0)。

       TRAP的一个变化版本是TRAPD（D代表Declare），所以上面代码等阶于

TRAPD(LeaveError,MyFunctionL());

异常退出函数

       异常退出函数有多个版本：

User::Leave(code);//简单Leave
User::LeaveNoMemory();//等价于Leave(KErrNoMemory)
User::LeaveIfError(error);//如果error小于0，则调用Leave(error)
User::LeaveIfNull(TAny *ptr);//如果ptr为Null,则调用Leave(KErrNoMemory)

 

后缀为“L”函数的意义：就是表示函数内含有“Leave**”

 

下面讲解后缀为“LC”函数的意义

       请看以下代码

void MyFunction
{
       TInt *buff;

       buff = new TInt;
       ...
       funcL();
       ...
       delete buff;
}

       如果funcL发生异常，则将永不调用delete buff，为防止这样的情况发生，可将delete buff放在funcL前。另一种选择是将要分配堆的变量变为类的成员变量，并在析构函数中完成delete。因为在MyFunction由于funcL 异常出退时退出，会析放自动变量。这是一种很笨拙的方法。

 

       Symbian采用了一种机制――清理栈，请看以下代码

void FuncL()
{

       CMyObject *myObj = new CMyObject;
       CleanupStack::PushL(myObj);

       TInt *buff = new TInt[1000];
       CleanupStack::PushL(buff);
       DoSomethingL();
       Cleanupack::Pop(2);
 

       delete myObject;

       delete buff;
}

       如果DoSomethingL()异常退出，则FuncL返回到调用函数之前，释放清理本中的每个指针（在这里是myObj和buff）。

       如果DoSomethingL()没有异常退出，则要通过CleanupStack::Pop(2)弹出两个项。

       正如你所看到的CleanupStack::PushL也包含“L”，但是可以确信PushL只有在项被压入清理栈中后，才异常退出，所以即使PushL失败时，清理栈中的项也能被清除。

       Pop函数的一个变种是CleanupStack::PopAndDestory()，这个函数可以替换ClearupStack::Pop(2)和两条delete

 

PushL的方法

PushL(CBase *)//在清除时会使用delete删除该对象，由于CBase类的析构函数是虚函数，因此调用了派生类的析构函数
PushL(TAny *)//非CBase类即TAny类，则不调用delete，而改为User::Free()函数。

      

LC函数

       以LC结尾的函数提供了一个附加的便利――在成功完成后，返回值会被压入清理栈中，但别忘记弹出清理栈中的指针。如下面代码

void FuncL
{

       TInt *buff;

       buff = User::AllocLC(1000);
       .....
       FooL();
       CleanupStack::PopAndDestroy();
}

 

双阶段构造函数

       Symbian有一个特别的语法：

 

 CMyObject *obj = new(ELeave)CMyObject;

       它是new运算符的重载，对于一条传统的new语句（CMyObject *obj = new CMyObject） 来说，编译器以这样的方式调用内置的new函数原型:new(TInt)――TInt参数是对象的大小。但是如果在new后加ELeave，编译器则改为 这样的调用函数原型:new(TInt,TLeave)，TInt是对象的大小，而ELeave是参数ELeave的数据类型，ELeave只是一个哑元 变量，它的目的是引起该重载new的调用，Symbian OS实现了这个重载new函数是用于在内存分配失败是时异常退出。

       现在有一种情形：如果在构造函数本身发生异常退出呢？这是Symbian OS中的一个问题，在new运算符函数分配内存后，就立即（在后台）调用构造函数，没有机会让程序员把指向已分配内存的指针压入清理栈。因此，如果在构造期间发生异常退出，就会得到一个“野指针”。

       Symbian对应这个问题的策略是“双阶构造函数”，类中提供一个名为ContructL()的方法用来完成对象的构造（成员的堆分配）。以下是在Symbian中常见的语法：

CMyObj* CMyObj::NewL()
{

       CMyObj *self = NewLC();
       CleanupStack::Pop();//调用LC函数后，要负责弹出操作

       return self;
}
 
CMyObj* CMyObj::NewLC()
{

       CMyObj *self = new(ELeave)CMyObj;
       CleanupStack::PushL(self);//LC函数要负责将指针压入清理栈
       self->ConstructL();//构造内部成员

       return self;
}

 

       至此，Symbian最重要的关键字解释已完结，理解了上述规则对日后的开发大有帮助。