Symbian学习笔记(1)——基本概念

 

原文这是学习笔记的第二篇，我觉得作为第一篇更合适，转载如下：

第一次打开SymbianC++的程序源代码，第一感觉就是“这是C/C++吗？咋这么眼生啊”。
看代码看书，才算是稍稍明白了一点，其实无非就是typedef罢了，symbian可比brew定义了更多的东西。

这是以后干活的基础，所以做个笔记，省得忘了。

一、基本数据类型

这个比较简单，都在e32def.h中写着呢。也就是以下这几个类型要注意一下,以后照着写罢了，含义也很明了，不用多说。

typedef  void              TAny;

typedef signed  char          TInt8;
typedef unsigned  char          TUint8;
typedef  short   int          TInt16;
typedef unsigned  short   int      TUint16;
typedef  long   int          TInt32;
typedef unsigned  long   int      TUint32;
typedef signed  int          TInt;
typedef unsigned  int          TUint;

typedef  float              TReal32;
typedef  double              TReal64;
typedef  double              TReal;

typedef unsigned  char          TText8;
typedef unsigned  short   int      TText16;

typedef  int              TBool;

typedef TUint32         TLinAddr;  // Defines a linear (virtual) address type.

二、描述符

这个东西比较有趣，其实说白了，也就是两个我们以前常用的玩意儿：String和malloc。不过在symbian中把描述符分为三类：缓冲描述符、指针描述符和堆描述符。

A.缓冲描述符：TBuf、TBufC
类似于char[]，也就是说它是一个字符串的表示方法，比如：TBuf<20> str;与我们以前写的char str[20];意思基本一样。
不过，描述符可以包含一些方法，就象我们用String主要就是冲着它的方便的字串处理方法去的。

B.指针描述符：TPtr、TPtrC
类似于char *，也就是说这是一个字符（字节）指针的另类表示罢了。

C.堆描述符：HBufC
类似于我们用malloc开辟的一块空间，比如：HBufC * buf = HBufC::NewL(128);与 byte * buf = (byte*)malloc(128);的意思也是基本一样的。

还有一种抽象的描述符TDes和TDesC，是其它描述符的基类。

所有描述符名称后面的C表示它是一个不可修改的描述符。换句话说就是，所有不带C的描述符是在带C描述符的基础上增加了一些进行修改操作的函数。

要记住的是描述符带给我们的便利。
比如这几个函数：

Length()         得到字串的真实长度(元素个数），而Size()则是得到它所占的字节数。
Left()/Right()/Mid()      是用来获取子字符串的函数。
Compare()      比较函数。
Locate()/LocateReverse()/Find()/Match()     则可以查找子串或字符。
Copy()/Delte()/Insert()/Replace()/Trim()/Append()/Zero()      则可以对描述符的内容进行修改操作。
Num()      可以将数值转成字符串。
Format()      类似于sprintf，比较常用，格式化输出。不过还有同系的其它函数也许更方便，如AppendFormat()/AppendNum()等等。

对于堆描述符，需要注意的地方有三点：

一是Des()，因为HBufC带C是不可修改的描述符，所以如果我们要修改它，则需要用buf.Des()得到一个指向它的指针描述符。如下句：

_LIT(KHello, " hello china " );

HBufC  *  buf  =  HBufC::NewL( 64 );
* buf = KHello;

TPtr p  =  buf -> Des();
p[ 0 ] = ' H ' ;

二是在TDesC中有一个AllocLC()可以分配内存得到HBufC描述符，与HBufC::NewL()是一样的。而且HBufC中也有ReAllocL可以重新分配内存，就象realloc一样。

三是区分一下两句话的含义：

TPtr p = buf -> Des();
TPtr p(buf -> Des());

第一句只是根据buf当前的真实长度得到一个指针（p的最大长度与当前的实际长度一样，就是buf此时的真实长度11），而第二句则完全用buf的信息来构造了p，所以它的最大长度应该是64,虽然当前的真实长度也是11。

还有一个与描述符相关的宏很常用，需要注意一下：_LIT(常量名称，字串值）。比如：

_LIT(KSayHelloSTR, " Hello world. " );

而那个_L宏不提倡用了，因为效率太低的原因。

这里的KSayHelloSTR是另一种描述符TLitC。而TLitC提供两个运算符要注意：

&操作符能得到它的const TDesC*，而()操作符则得到它的const TDesC&。

KSayHelloSTR().Length();  // 得到这个字串的长度

TBuf < 256 >  str;
str.Format(KFormatSTR, & KSayHelloSTR);  // 得到这个字串的引用地址

具体关于描述符的信息可以参考H文件：e32des16.h

三、错误处理

有三个概念，一是Leave。最常见的地方是对new操作符的重载new(ELeave)，表示此时的构造会产生内存不足的现象。
有了new(ELeave)，我们就可以放心地在new一个对象之后直接使用它而不需要去判断是否构造成功，因为如果不成功会抛出错误并返回上层。

第二个概念配合Leave，有一个宏TRAPD(error,Func)类似于try...catch...。
也就是说如果Func函数中发生了Leave，则error能得到错误码。一般在程序中可以用User::Leave()来抛出错误，类似于throw new Exception的操作。

第三个概念也是最常用的，就是清理栈CleanupStack的使用。
取代TRAPD宏的使用，我们可以在可能发生Leave之前将指针push到cleanupstack中，在正确完成之后再将它pop出来，如果万一不成功，系统会帮我们将cleanupstack中的东西销掉。这样就方便了很多。

一般的代码类似于：

CMyCls  *  mc = new  (ELeave) CMyCls;
CleanupStack::PushL(mc);
me -> doSth1L();
me -> doSth2L();
CleanupStack::PopAndDestroy();

一般我们是将局部变量用cleanupstack来保护一下，但是对于类的成员变量则不能这样做（否则会二次销毁，产生严重错误）。
此外，在pop时超出范围了，压几个就弹几个，如果不小心把其它的内容给弹出来，也可能会引起严重错误的。所以，Pop有一个重载Pop(3,pA)这里表示弹出三个对象并且比较一下最后出栈的是不是pA。

四、两阶段构造

一般Symbian的类不会提供public的构造函数（不建议这么做），因为它提倡所谓的“两阶段构造”方法。定义为：

A)构造函数是protected或者privted的，并且不能包含引起Leave的操作。
B)实现两个静态函数NewL和NewLC，来代替构造函数提供给用户使用。
C)实现一个ContructL函数实现第二阶段的构造，其实大多数初始化的工作可以放在这里进行。

两阶段构造的代码相当地格式化了，比如两个静态函数NewL和NewLC的代码一般是这样的：

CMyClass  *  CMyClass::NewL()
... {
  CMyClass * self=NewLC();
  CleanupStack::Pop();
  return self; 
}
CMyClass  *  CMyClass:NewLC()
... {
  CMyClass * self = new(ELeave) CMyClass;
  CleanupStack::PushL(self);
  self->ContructL();
  return self;
}

而在ContructL中一般可以做一些真正的构造函数里的操作，例如分配内存、创建窗体之类的活儿。

五、命名规则

这也是一个需要注意的地方，按教材上所言列举如下：

类的名称前缀有T、C、M和R四个，分述如下：
T表示基本类，它位于栈里，就当作是一个结构吧。
C表示常规的类，继承于CBase的，这是C++标准的类的概念，所以有构造要析构。
M表示是一个接口，很好理解，它肯定含有纯虚函数。
R表示是一个系统资源，比如文件、网络等等，所以它肯定有Open有Close。

还有，K开头表示常量、E开头表示枚举也要记得。
形参用a开头，类成员变量用i开头，这此规则我们在自动生成的代码中也能看到。

还有函数的命名上也有讲究，不过不是开头而是结尾：象L表示可能会有Leave，LC表示不但可能有Leave而且它会被自动放在CleanupStack中。
还有两个二阶段构造又有三个函数名称固定了：NewL、NewLC和ContructL。

引用自：http://www.sf.org.cn/Article/lumen/200803/20902.html