leave (不知该怎么翻译，就先叫离开吧） 这个词我们在第二课提到过， 知道它是Symbain版本的异常处理。 这一课我们详细讲解它的意义和用法。 
 
leave (不知该怎么翻译，就先叫离开吧） 这个词我们在第二课提到过， 知道它是Symbain版本的异常处理。 这一课我们详细讲解它的意义和用法。 首先我们要明白为什么要离开? 当程序运行到一个地方无法正常继续的时候， 比如内存耗尽， 或者当前状态无法进行某个操作的时候我们不能简单的退出程序，或者忽略这些错误。 前者使得界面不够友好， 而后者可能导致不可估计的问题。 所以我们需要在这一点上离开。 让上一层的使用我们这个函数的代码去处理我们遇到的错误。 上一层代码可以根据但是的上下环境决定该如何处理这个错误。
离开的基本用法：
假设我们有一个函数提取一个数组的值：
TInt GetL(TInt aIndex)
{
if(aIndex < 0 || aIndex >= KArraySize)
{
User::Leave(KErrArgument);
}
else
{
return iArray[aIndex];
}
}
要使用这个函数， 我们可以：
TInt x, err;
TRAP(err, x = GetL(5);)
if(err != KErrNone)
{
//输出错误信息等等
}
...

首先注意函数名，这是一条规范： 凡是有可能离开的函数，名称都要以L结尾。这包括
在函数实现中使用任何形式的Leave （Leave, LeaveIfNull, LeaveIfError等等）和可leave的函数， 而又没有TRAP掉他们的的函数。
以上的GetL函数当aIndex不在合法范围内的时候就会leave, KErrArgument是其原因（错误的参数）。 使用GetL函数的时候我们可以使用TRAP宏来捕捉离开, 所以当GetL 离开的时候， 就会输出错误信息等等。 使用GetL的代码并不一定需要TRAP只要把他自己声明为可离开的函数就可以， 但是要保证终归这些函数要被TRAP掉。 图形界面程序的框架在程序入口处提供了TRAP所以我们可以使用离开而不用TRAP一些普遍性的问题（比如内存不足）。但是文字程序一般需要我们自己提供TRAP.
另外还有一点就是， TRAP这个宏必须在一个CTrapCleanup的实例被创建以后才可以使用。 文字Helloworld中使用了头文件commonframework， 在Examples/basics/commonframework目录下， 我们可以看到:
CTrapCleanup* cleanup=CTrapCleanup::New(); // get clean-up stack
TRAPD(error,callExampleL()); // more initialization, then do example
//TRAPD是TInt error; TRAP(error,callExampleL()); 的缩写版。
delete cleanup; // destroy clean-up stack
也就是说当你的进程中还没有CTrapCleanup实例的时候， 你需要创建它才可以使用TRAP，当你不再使用TRAP的时候就删除这个实例。

有了离开这个基础，我们下一课就可以讲CleanupStack 和 二层构造的概念了。 之后大家就不会觉得Symbian 程序中实例的构造看起来很复杂了。

习题：
1。 在Helloworld中创建一个可leave的函数， 并在doExampleL()中调用，看看不TRAP它的结果是什么。（也就是依靠commonframework中的TRAP) 然后再doExample 中TRAP它， 看看结果有什么不同？
 
本文简介Descriptor。 Symbian OS 中不使用我们所熟悉的c 字符串(char*) 或者c++ 的string。 Symbian 的字符串是通过descriptor实现的。我们的第一个Symbian 程序，文字版Helloworld中是这样使用的： _LIT(KHelloWorldText,"Hello world!n");
console->Printf(KHelloWorldText);
_LIT()是一个宏，它声明了一个descriptor：KHelloWorldText， 其内容是"Hello world!"。下面console->Printf的参数就是一个descriptor.
Descirptor是一个灵活的设计， 它充分考虑到小型设备的各种局限性。 为此提供了很个类，有些是可以修改的，有些是不能修改的， 有些放在stack上，有些放在heap上。 NewLC网站上有一个descriptor的结构图：http://www.newlc.com/article.php3?id_article=12 。
其中包含了八个类， 这些并不是全部的descriptor类， 但是已经足够我们课程目前的使用。其中TDesC是最基本的类。 其他所有的descriptor类都是由它继承而来。 TDes是最基本的可以修改的类。凡是以C后缀的类都是不可修改的。
结构图下面是5各最常用的descriptor类的内存示意图。
TBufC<5> 中的5是它的长度， 它表示的是"NewLC"这个字符串， 是不可更改的。
TBuf<8> 8是它的最大长度， 而当前只使用了5个字节，它的内容是可更改的，但是注意内容长度不可以大于他的最大长度
TPtrC 是一个descriptor 指针类， 它是一个不可修改的指针， 指向不可修改的"NewLC"的地址。
TPtr 是一个可修改的descriptor指针类， 指向可修改的"NewLC"的地址。
HBufC 的H代表Heap，是专门用来在Heap上创建字符串， 其他的descriptor类的字符串一般都放在stack上。
一般来说要尽可能的使用heap内存， 因为stack的内存要更有限， 如果在stack上访大量的字符串就很容易导致内存不足。
这些类都由很多函数来使用，修改，查询他们的字符串， 大家可以参考Developer Library中的API Reference.
_LIT()还有一个更简单的版本， helloworld中的两行可以改写为：
console->Printf(_L("Hello world!n"));

Symbian OS支持多线程， 但是用得很少， 因为官方建议尽可能使用Active Object代替。 我们将在下一课讲解Active Ojbect 和推荐使用它的原因。 
 
Symbian OS支持多线程， 但是用得很少， 因为官方建议尽可能使用Active Object代替。 我们将在下一课讲解Active Ojbect 和推荐使用它的原因。 考虑对于

普通的程序员来说多线程是一个要熟悉的多的概念， 我们在这一课将通过一个很简单的例子来介绍它在Symbian OS中的实现。 首先， RThread 类代表线程，我们可以通过这个类来创建，启动，停止，关闭线程，它还包括其他一些有用的API， 大家可以参看文档。
要创建线程RThread中一共有3 个Create函数， 基本大同小异，我们这里就用第一个：

TInt Create(const TDesC& aName,TThreadFunction aFunction,TInt aStackSize,TInt aHeapMinSize,TInt aHeapMaxSize,TAny *aPtr,TOwnerType aType=EOwnerProcess);
aName: 线程的名称
aFunction： 线程要执行的函数
aStackSize: 栈的大小， 一般都使用KDefaultStackSize（缺省值）
aHeapMinSize: 堆的最小值
aHeapMaxSize: 堆的最大值
aPtr: aFunction的参数， 可以是任意指针
aType: 缺省值为EOwnerProcess
当一个线程被创建后， 它处在非活动状态， 要启动它需要调用 Resume()函数。
最后， 我们要知道线程是否已经执行完毕， 有很多方法，这里用了一个最简单的：semaphore.

下面将介绍一个多线程的例子，因为sdk中用到多线程的例子比较复杂， 我在文字版的helloworld上建立了一个很简单的例子。 不过你再按照本文修改

helloworld之前，建议把原本的例程做一个备份， 这样万一以后忘了怎么写helloworld也不至于去下载一个新的sdk:)

这个程序创建两个线程， 他们同时试图修改十个整数：num, 运行的时候我们会看到num的值总是徘徊于初始值：100左右。
修改过的helloworld.cpp 在：http://homepage.ntlworld.com/jiayao/Symbian_Junior_Tutorial/Lesson8/helloworld.cpp

TInt ThreadFunction(TAny* aAny) 是线程要执行的函数， 它的名称可以是任意的， 但是参数必须是(TAny* aAny). 我们可以用这个指针来传递任何数据， 可

以是整数，Descriptor， 数组等等。 返回值必须是TInt. 我的实现很简单， 它对num 进行100次改动， 根据aAny的值来定改动的方向和幅度。 每次改动之间

等待0-1秒。

下边doExample是程序的入口， t1,t2为两个线程，注意每一个线程创建之后的CleanupClosePushL(...), 这个是CleanupStack::PushL的延伸。 假如创建t1后我

们直接创建t2, 然后在创建t2的过程中发生错误，通过User::LeaveIfError(err);离开， 那么t1所分配的内存就泄漏了。 为了避免这个情况， 我们要把t1的放

到清洁栈上。 然而记得我们第2课讲的，R-class本身不动态分配内存， 他只是系统资源的一个句柄。要回收资源就必须使用它的Close函数。

CleanupClosePushL() 就是为此情况设计的。 它把对象放在清洁栈上， 当离开发生的时候自动调用那个对象的Close函数。

然后我们创建一个Semaphore来判断线程是否结束， 当一个线程结束时， 它会调用semaphore的Signal函数使它的值加一。

调用Resume来启动线程。

当它的值在2你内的时候我们每1/10秒输出一次num的值。

最后从清洁栈上取下t1,t2, 他们的Close函数会被自动调用。