学习Symbian的基本概念
一、基本数据类型
这个比较简单,都在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。