symbian 基本概念

Symbian學習筆記(2)——基本概念 第一次開啟SymbianC++的程式原始碼，第一感覺就是“這是C/C++嗎？咋這麼眼生啊”。
看代碼看書，才算是稍稍明白了一點，其實無非就是typedef罷了，symbian可比brew定義了更多的東西。

這是以後幹活的基礎，所以做個筆記，省得忘了。

一、基礎資料型別 (Elementary Data Type)

這個比較簡單，都在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