學習Symbian的基本概念

一、基本數(shù)據(jù)類型

這個比較簡單，都在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[]，也就是說它是一個字符串的表示方法，比如：TBuf20> str;與我們以前寫的char str[20];意思基本一樣。

不過，描述符可以包含一些方法，就象我們用String主要就是沖著它的方便的字串處理方法去的。

B.指針描述符：TPtr、TPtrC

類似于char *，也就是說這是一個字符(字節(jié))指針的另類表示罷了。

C.堆描述符：HBufC

類似于我們用malloc開辟的一塊空間，比如：HBufC * buf = HBufC::NewL(128);與 byte * buf = (byte*)malloc(128);的意思也是基本一樣的。

還有一種抽象的描述符TDes和TDesC，是其它描述符的基類。

所有描述符名稱后面的C表示它是一個不可修改的描述符。換句話說就是，所有不帶C的描述符是在帶C描述符的基礎上增加了一些進行修改操作的函數(shù)。

要記住的是描述符帶給我們的便利。

比如這幾個函數(shù)：

Length() 得到字串的真實長度(元素個數(shù))，而Size()則是得到它所占的字節(jié)數(shù)。

Left()/Right()/Mid() 是用來獲取子字符串的函數(shù)。

Compare() 比較函數(shù)。

Locate()/LocateReverse()/Find()/Match() 則可以查找子串或字符。

Copy()/Delte()/Insert()/Replace()/Trim()/Append()/Zero() 則可以對描述符的內容進行修改操作。

Num() 可以將數(shù)值轉成字符串。

Format() 類似于sprintf，比較常用，格式化輸出。不過還有同系的其它函數(shù)也許更方便，如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一樣。

三是區(qū)分一下兩句話的含義：

TPtr p=buf->Des();

TPtr p(buf->Des());

第一句只是根據(jù)buf當前的真實長度得到一個指針(p的最大長度與當前的實際長度一樣，就是buf此時的真實長度11)，而第二句則完全用buf的信息來構造了p，所以它的最大長度應該是64,雖然當前的真實長度也是11。

還有一個與描述符相關的宏很常用，需要注意一下：_LIT(常量名稱，字串值)。比如：

_LIT(KSayHelloSTR,Hello world.);

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

這里的KSayHelloSTR是另一種描述符TLitC。而TLitC提供兩個運算符要注意：

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

KSayHelloSTR().Length(); //得到這個字串的長度

TBuf256> str;

str.Format(KFormatSTR,KSayHelloSTR); //得到這個字串的引用地址

具體關于描述符的信息可以參考H文件：e32des16.h

三、錯誤處理

有三個概念，一是Leave。最常見的地方是對new操作符的重載new(ELeave)，表示此時的構造會產生內存不足的現(xiàn)象。

有了new(ELeave)，我們就可以放心地在new一個對象之后直接使用它而不需要去判斷是否構造成功，因為如果不成功會拋出錯誤并返回上層。

第二個概念配合Leave，有一個宏TRAPD(error,Func)類似于try...catch...。

也就是說如果Func函數(shù)中發(fā)生了Leave，則error能得到錯誤碼。一般在程序中可以用User::Leave()來拋出錯誤，類似于throw new Exception的操作。

第三個概念也是最常用的，就是清理棧CleanupStack的使用。

取代TRAPD宏的使用，我們可以在可能發(fā)生Leave之前將指針push到cleanupstack中，在正確完成之后再將它pop出來，如果萬一不成功，系統(tǒng)會幫我們將cleanupstack中的東西銷掉。這樣就方便了很多。

一般的代碼類似于：

CMyCls * mc=new (ELeave) CMyCls;

CleanupStack::PushL(mc);

me->doSth1L();

me->doSth2L();

CleanupStack::PopAndDestroy();

一般我們是將局部變量用cleanupstack來保護一下，但是對于類的成員變量則不能這樣做(否則會二次銷毀，產生嚴重錯誤)。

此外，在pop時超出范圍了，壓幾個就彈幾個，如果不小心把其它的內容給彈出來，也可能會引起嚴重錯誤的。所以，Pop有一個重載Pop(3,pA)這里表示彈出三個對象并且比較一下最后出棧的是不是pA。

四、兩階段構造

一般Symbian的類不會提供public的構造函數(shù)(不建議這么做)，因為它提倡所謂的“兩階段構造”方法。定義為：

A)構造函數(shù)是protected或者privted的，并且不能包含引起Leave的操作。

B)實現(xiàn)兩個靜態(tài)函數(shù)NewL和NewLC，來代替構造函數(shù)提供給用戶使用。

C)實現(xiàn)一個ContructL函數(shù)實現(xiàn)第二階段的構造，其實大多數(shù)初始化的工作可以放在這里進行。

兩階段構造的代碼相當?shù)馗袷交耍热鐑蓚€靜態(tài)函數(shù)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中一般可以做一些真正的構造函數(shù)里的操作，例如分配內存、創(chuàng)建窗體之類的活兒。

五、命名規(guī)則

這也是一個需要注意的地方，按教材上所言列舉如下：

類的名稱前綴有T、C、M和R四個，分述如下：

T表示基本類，它位于棧里，就當作是一個結構吧。

C表示常規(guī)的類，繼承于CBase的，這是C++標準的類的概念，所以有構造要析構。

M表示是一個接口，很好理解，它肯定含有純虛函數(shù)。

R表示是一個系統(tǒng)資源，比如文件、網(wǎng)絡等等，所以它肯定有Open有Close。

還有，K開頭表示常量、E開頭表示枚舉也要記得。

形參用a開頭，類成員變量用i開頭，這此規(guī)則我們在自動生成的代碼中也能看到。

還有函數(shù)的命名上也有講究，不過不是開頭而是結尾：象L表示可能會有Leave，LC表示不但可能有Leave而且它會被自動放在CleanupStack中。

還有兩個二階段構造又有三個函數(shù)名稱固定了：NewL、NewLC和ContructL。