描述符Descriptors

<上>概念和使用

接觸Symbian已經(jīng)一個(gè)半月多了，自從上個(gè)月熟悉了框架之后，一直都不敢再寫什么東西了，因?yàn)闆]有經(jīng)歷過代碼怎么可能寫得出東西呢？起筆猶豫了很久，打算涉足Symbian與標(biāo)準(zhǔn)C++的一個(gè)不同點(diǎn)——描述符。希望自己能夠借這個(gè)機(jī)會(huì)搞清楚描述符這個(gè)東西。

一、總介

由于手機(jī)系統(tǒng)的資源區(qū)別于PC，為此為了更好的在內(nèi)存受限設(shè)備上處理內(nèi)存緩沖，Symbian提供了獨(dú)特的描述符，用以存儲(chǔ)和操作字符串、以及管理二進(jìn)制數(shù)據(jù)和其它串行化的復(fù)雜對(duì)象（serialized compound objects）。

Symbian OS的很多API調(diào)用的參數(shù)都是描述符，同時(shí)Symbian也為描述符提供了很多的操作函數(shù)。但是描述符本身其實(shí)就是一個(gè)封裝了數(shù)據(jù)及其長(zhǎng)度的內(nèi)存塊類。作為字符串處理類，它與標(biāo)準(zhǔn)C++的以'\0'結(jié)束符的字符串有區(qū)別，即它沒有結(jié)束符；描述符在處理字符串和二進(jìn)制數(shù)據(jù)時(shí)又有不同：首先Symbian使用Unicode，所以字符串通常存于16位描述符中，而二進(jìn)制數(shù)據(jù)存儲(chǔ)于8位描述符中（通常在底層通信中用的都是8位的描述符）；其次如果描述符中包括二進(jìn)制數(shù)據(jù)，則描述符的字符串操作方法不可用（我的理解是可以用，但是不能當(dāng)字符串來用，所以也就沒有意義了。至于處理串行化對(duì)象，本人沒有接觸所以暫時(shí)略過）。

二、描述符類型分類及其相互關(guān)系

描述符主要有四類，但是我們通常將文字常量也作為描述符的一類，所以就有了五類，以下就是常見分類：

·       抽象類（Abstract）：（TDes、TDesC、Tdes8、TdesC8），其他描述符的基類，僅提供接口和基本功能，不能被實(shí)例化，一般只用作函數(shù)的參數(shù)。

·       文字常量（Literal）：（TlitC、_LIT()），用于存儲(chǔ)文字字符串（literal string），即C中字符串常量，通常使用_LIT()這種方式（當(dāng)然還有_L()和_L8()的描述方式，但都不提倡用）。

·       棧類（Buffer）：（Tbuf、TbufC、 Tbuf8、TbufC8），數(shù)據(jù)存儲(chǔ)于棧上，最基本的描述符變量類型，大小在編譯時(shí)確定，包含描述符本身數(shù)據(jù)，使用最為普遍。

·       堆類（Heap）：（HbufC、HbufC8），數(shù)據(jù)存儲(chǔ)于堆上，大小在運(yùn)行時(shí)確定，也就是是用來處理動(dòng)態(tài)申請(qǐng)的描述符類。在C/C++中用過動(dòng)態(tài)內(nèi)存的都知道，動(dòng)態(tài)內(nèi)存是啥回事，這里堆類描述符用的時(shí)候，也是差不多，由于堆描述符沒有構(gòu)造函數(shù)，所以只能聲明為指針類型，通過堆描述符類內(nèi)靜態(tài)函數(shù)NewL方法申請(qǐng)內(nèi)存，具體方法如下

HBufC* errorTitleCode = HBufC::NewLC(50);

HbufC* unUseCode = NULL;

·       指針類（Pointer）：（TPtr、TPtrC、TPtr8、TPtrC8），本身不包含描述符數(shù)據(jù)，但是包含長(zhǎng)度數(shù)據(jù)，而且還包含一個(gè)指向位于描述符之外數(shù)據(jù)的指針。

從以上分類可知，描述符有8位和16位寬度的區(qū)別，還有可修改和不可修改的區(qū)別，具體的區(qū)別我從內(nèi)存的角度出發(fā)列表如下：

注：

1、  表中空出的內(nèi)容，我暫時(shí)還不知道具體的值是多少。其中的b是bit的意思；

2、  在實(shí)際操作中，定義的描述符長(zhǎng)度和內(nèi)存實(shí)際使用長(zhǎng)度會(huì)有不一致問題，原因是描述符也是按4字節(jié)進(jìn)行邊界對(duì)齊的。

由如表所示的內(nèi)存關(guān)系可能顯得有點(diǎn)亂，如果能將每個(gè)類用UML類圖（包括詳盡的成員變量和成員函數(shù)，類的頭文件在e32des16.h和e32des8.h中）來表示就更直觀了，在Symbian官方網(wǎng)站有一張類簡(jiǎn)圖，我先將此作為繼承關(guān)系的簡(jiǎn)圖在這里作為演示用

三、描述符的使用

介紹到這里應(yīng)該具體講每一個(gè)描述類的使用了，我發(fā)現(xiàn)有兩篇中文文檔整理的很好，在這里，我只做一些驗(yàn)證性的介紹，讀者可以參閱我在文章后列出的兩篇文檔。由于要略過不能實(shí)例化的抽象類，且按照從簡(jiǎn)單到復(fù)雜的過程來敘述：

1、  文字描述符常量

a、_LIT()可以生成個(gè)常量名，以便以后重復(fù)使用，例如

_LIT(KMyFile, "c:\System\Apps\MyApp\MyFile.jpg");

_LIT()宏的結(jié)果（就是上面的KMyFile）實(shí)際上是個(gè)文字描述符（literal descriptor）TLitC，它可以在任何使用TDesC&的地方使用。（但是TlitC已經(jīng)不推薦使用了）。

b、_L()可以生成一個(gè)指向字符值的地址（TPtrC），它經(jīng)常被用來傳遞字符串到函數(shù)中（包括描述符的構(gòu)造函數(shù)和格式化函數(shù)）；同理_L8()則可以生成一個(gè)指向二進(jìn)制數(shù)據(jù)的地址（TPtrC8）舉例如下：

//常用的通知函數(shù)

NEikonEnvironment::MessageBox(_L("Error: init file not found!"));

//數(shù)字轉(zhuǎn)字符串

TBuf16<20> buf;//

TInt iNum = 20;

buf.Format( _L( "%d" ) , iNum  );

2、  棧描述符

棧類描述符聲明時(shí)必須指定描述符的最大長(zhǎng)度，否則無法聲明和定義，下面舉例

例1：構(gòu)造

// 直接從字符串中構(gòu)造

_LIT(Ktext, "TestText");

TBufC<10> Buf (Ktext);

// 或從字符串賦值

TBufC<10> Buf2;

Buf2 = Ktext;

// 從已有的對(duì)象中生成新的TBufC

TBufC<10> Buf3(Buf2);

TBufC<n>一般用來存儲(chǔ)文本數(shù)據(jù)，而TBufC8<n>則用來存儲(chǔ)二進(jìn)制數(shù)據(jù)。盡管這里的對(duì)象表示數(shù)據(jù)是不能被修改的（因?yàn)橛袀€(gè)后綴C代表了常量的意思），但仍然有兩種方式可以用來修改數(shù)據(jù)內(nèi)容：這里的數(shù)據(jù)可以用賦值的方式替換掉；使用Des()函數(shù)構(gòu)造出一個(gè)TPtr對(duì)象，這樣就可以用它來修改數(shù)據(jù)。

例2：修改數(shù)據(jù)

_LIT(Ktext , "Test Text");        

_LIT(Ktext1 , "Test1 Text");

_LIT(KXtraText , "New:");

_LIT(NewText , "New1");

_LIT(NewText1 , "New2");

TBufC<10> Buf1 ( Ktext );//Buf1長(zhǎng)度為9 內(nèi)容 “Test Text”

TBufC<10> Buf2 ( Ktext1 );//Buf2長(zhǎng)度為10 內(nèi)容 “Test1 Text”

// 通過賦值的方式改變數(shù)據(jù)

Buf2 = Buf1; //Buf2長(zhǎng)度變?yōu)?/span>9 內(nèi)容 “Test Text”

//通過使用Des()生成指針改變TBufC的數(shù)據(jù)

TPtr Pointer = Buf1.Des();

// 刪除后四個(gè)字符

Pointer.Delete(Pointer.Length()-4, 4 ); //Buf1長(zhǎng)度變?yōu)?/span>5 內(nèi)容“Test ”

                               //但是內(nèi)存應(yīng)該沒變

// 增加新的數(shù)據(jù)

Pointer.Append(KXtraText);//Buf1長(zhǎng)度為9 內(nèi)容為“Test New：”

// 也可以使用下列方式改變數(shù)據(jù)      

TBufC<10> Buf3(NewText);

Pointer.Copy(Buf3);//Buf1長(zhǎng)度為4，內(nèi)容為New1

// 或直接從字符串里獲得數(shù)據(jù)

Pointer.Copy(NewText1);//Buf1長(zhǎng)度為4，內(nèi)容為New2

以上介紹的是不可修改的棧描述符，而可修改的描述符就不用通過那么復(fù)雜的方法來實(shí)現(xiàn)修改，它直接可以用Copy、Delete等方法，但是無論可修改的還是不可修改的，一旦指定最大的數(shù)據(jù)長(zhǎng)度后，最大長(zhǎng)度就不能進(jìn)行修改了。修改的只是數(shù)據(jù)內(nèi)容，而數(shù)據(jù)內(nèi)容修改的受限條件是不能超過聲明或定義時(shí)的最大長(zhǎng)度。（個(gè)人以為從內(nèi)存角度來說，不可修改類型的缺少最大長(zhǎng)度，所以嚴(yán)格上來說為了減少錯(cuò)誤，修改數(shù)據(jù)內(nèi)容是不允許的）

3、  堆描述符

堆描述符雖然都是不可修改類型的，但是它仍然具有構(gòu)造和修改，與棧描述符不同的是：首先對(duì)內(nèi)存需要顯示釋放，其次是堆描述符沒有最大長(zhǎng)度的限制，任何時(shí)候都可以用ReAlloc（）函數(shù)重新申請(qǐng)分配。具體見示例：

       //例1、構(gòu)造

       //有兩種方式來生成一個(gè)Heap Descriptor

       //第一種方式用New(),NewL(),或NewLC()

       //如下操作便可以構(gòu)建一個(gè)存放數(shù)據(jù)的空間，空間為15，不過目前大小為0

       HBufC * Buf = HBufC::NewL(15);

       //第二種方式是采用Alloc()，AllocL()或AllcLC()來處理，

       //不過這是已經(jīng)存在的數(shù)據(jù)的管理方式。新的Heap Descriptor

       //可以自動(dòng)的根據(jù)這個(gè)內(nèi)容來構(gòu)造。

       _LIT (KText , "Test Text");

       TBufC<10>  CBuf = KText;

       HBufC * Buf1 = CBuf.AllocL();

       CleanupStack::PushL(Buf1);

       //例2、修改

       //下面是通過賦值方式改變其數(shù)據(jù)的方法

       _LIT ( KText1 , "Text1");

       *Buf1 = KText1;

       // 通過可修改指針來改變數(shù)據(jù)的方式

       TPtr Pointer = Buf1->Des();

       //添加數(shù)據(jù)

       Pointer.Delete(Pointer.Length() - 2, 2);

       //刪除數(shù)據(jù)

       _LIT ( KNew, "New:");

       Pointer.Append(KNew);

       //例3、重新申請(qǐng)內(nèi)存

       Buf1 = Buf1->ReAllocL(KText().Length() + KNew().Length());

       CleanupStack::PushL(Buf1);

       //例4、釋放內(nèi)存

       //直接用delete

       delete Buf;

       Buf = NULL;

       //如果在使用NewL、ReAllocL等異常函數(shù)后我們使用清除棧壓入的話

       //那么我們也可以用清除棧來釋放內(nèi)存

       CleanupStack::PopAndDestroy();

       Buf1 = NULL;

注：關(guān)于以上用清除棧的方式，個(gè)人只是猜測(cè)，因?yàn)閷?duì)Symbian的異常處理三部曲，至今仍沒有很好的掌握，所以如果有什么誤用還望指點(diǎn)。

4、  指針描述符

其實(shí)關(guān)于指針描述符，我們?cè)谏厦嬉呀?jīng)用過可修改的指針TPtr了，下面返璞歸真，從TPtrC的構(gòu)造開始介紹使用

       //例1、用TBuf和TBufC構(gòu)造出TPtrC對(duì)象

       _LIT(KText , "Test Code");

       TBufC<10> Buf ( KText );

       //或者為 TBuf<10> Buf ( KText );

       // Creation of TPtrC using Constructor

       TPtrC     Ptr (Buf);

       // Creation of TPtrC using Member Function

       TPtrC     Ptr1;

       Ptr1.Set(Buf);

       //例2、用TText*構(gòu)造TPtrC

       const TText* text = _S("Hello World\n");

       TPtrC ptr(text);

       // 或者

       TPtrC Ptr2;

       Ptr2.Set(text);

       //如果要存儲(chǔ)TText的一部分?jǐn)?shù)據(jù)，我們使用下列方法

       TPtrC   ptr4(text, 5);

       //例3、從另一個(gè)TPtrC中構(gòu)造TPtrC

       const TText * text1 = _S("Hello World\n");

       TPtrC Ptr3(text1);

       // 從一個(gè)TPtrC中獲得另一個(gè)TPtrC

       TPtrC p1(Ptr3);

       // 或

       TPtrC p2;

       p2.Set(Ptr3);

以上是不可修改的TPtrC的構(gòu)造，相對(duì)應(yīng)的也有可修改的TPtr的構(gòu)造，不過我們下面省略了用Set()函數(shù)的構(gòu)造方法

       //例1、通過TBufC,HBufC的Des()方法獲取

       _LIT(KText, "Test Data");

       TBufC<10> NBuf ( KText );

       TPtr     Pointer = NBuf.Des();

       //例2、通過指定內(nèi)存區(qū)域和大小來生成

       const TText * Text = _S("Test Second");

       TPtr    Pointer1((TText*)Text, 11, 12);

       //例3、 通過另一個(gè)TPtr對(duì)象來生成

       TPtr     Pointer2 ( Pointer );

對(duì)于可修改的TPtr雖然前面用過，但是我們?cè)谶@里在簡(jiǎn)單的添加兩個(gè)例子加深下印象，并且說明指針修改的始終是它指向的描述符：

       //例1、改變已有TPtr數(shù)據(jù)的方式：賦值和Copy()方法  

       _LIT(KText, "Test Data");

       _LIT(K1, "Text1");

       _LIT(K2, "Text2");

       TBufC<10> NBuf ( KText );//NBuf內(nèi)容為“Test Data”

       TPtr     Pointer = NBuf.Des(); //Pointer指向NBuf的內(nèi)容       

       Pointer = K1; // NBuf內(nèi)容為“Text1”

       Pointer.Copy(K2); // NBuf內(nèi)容為“Text2”

       //例2、直接通過修改長(zhǎng)度改變數(shù)據(jù)內(nèi)容

       Pointer.SetLength(2); // NBuf內(nèi)容為"Te" 注：實(shí)際內(nèi)存的內(nèi)容應(yīng)該沒變

5、  抽象描述符

抽象描述符，沒有什么好說的，正如前面所說，只用在函數(shù)的形參中，通常要強(qiáng)調(diào)參數(shù)是不可修改的，就用const TDesC&表示，可修改的參數(shù)用TDesC&表示。

四、常用API函數(shù)羅列

下面再對(duì)描述符的幾個(gè)常用修改和不可修改API函數(shù)加以羅列

不可修改型：

//獲取屬性類

Length()，Size()

//查找、比較類

Compare()，Locate()，LocateReverse ()，Find()，Match()

//取描述符子串指針類

Left()，Right()，Mid()

可修改型：

//增加、插入、刪除類

Insert()，Delete()，Append()，Replace()， Trim()

//賦值類

Zero()，Copy()，Num()，Format()

本文涉及的兩篇文檔

Nokia官方培訓(xùn)(Symbian4300)筆記(六)—Descriptors（該文鏈接google里面找）

中文 Descriptors的使用

http://wiki.forum.nokia.com/index.php/%E4%B8%AD%E6%96%87_Descriptors%E7%9A%84%E4%BD%BF%E7%94%A8#TPtr.E7.9A.84.E4.BD.BF.E7.94.A8

后記：本想把涉及描述符的轉(zhuǎn)換也整理在一篇文章中的，但是后來發(fā)現(xiàn)整理完概念和使用已經(jīng)消耗了我一天多時(shí)間了，晚上部門要去喝茶，為此暫時(shí)到這里，明天周末在整理轉(zhuǎn)換問題。由衷感謝單位給我那么多時(shí)間在工作中學(xué)習(xí)，想想以前第一份工作時(shí)，在單位看書都要被老板說的歷史，發(fā)覺自己現(xiàn)在真的蠻幸運(yùn)的。

 本文由于圖片不能顯示同樣給出word版本地址http://m.shnenglu.com/Files/franksunny/描述符Descriptors(上).rar