本文最初发表于
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最重要的关键字解释已完结，理解了上述规则对日后的开发大有帮助。
