symbian基本数据类型转化汇集（二）

中文 Descriptors的使用

From Forum Nokia Wiki

任何Symbian的开发者都要对Descriptors 有所了解，因为在这里，无论是普通文本还是二进制数据，都要用到它，开发任何的应用软件，游戏或多媒体程序，也都要接触到它，在这里做个简单的介绍，自己也能重温并学习一下。以下内容摘自newlc的数篇经典文章，整理后也会加入了自己的一些内容和观点。

Contents [hide] 1 相关类的使用 1.1 TPtrC<n>的使用 1.2 TBufC<n>的使用 1.3 HBufC的使用 1.4 TPtr的使用 1.5 TBuf<n>的使用 2 描述符主要特性 3 Litterals

if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); }

[edit] 相关类的使用

[edit] TPtrC<n>的使用

它指向了一组数据，但没有包含处理方法。它是从TDesC中直接继承下来的，只包括从父类中继承的那些函数，以及它自身的构造和设置函数。如何为使用这个对象呢？有如下几种方式：

生成一个空的TPtrC对象，并使用Set()函数将它指向一组数据。

void Set(const TDesC16& aDes);

在构造它时，就将数据传递进去。

例1：用TBuf和TBufC构造出TPtrC对象。

LIT(KText , "Test Code");
TBufC<10> Buf ( KText ); //或者为 TBuf<10> Buf ( KText );
// Creation of TPtr using Constructor
TPtrC     Ptr (Buf);
// Creation of TPtr using Member Function
TPtrC     Ptr1;
Ptr1.Set(Buf);

例2：用TText*构造TPtrC

const TText * text = _S("Hello World/n");
TPtrC ptr(text);
// 或者
TPtrC Ptr1;
Ptr1.Set(text);
//如果要存储TText的一部分数据，我们使用下列方法
TPtrC   ptr4 ( text , 5 );

例3：从另一个TPtrC中构造TPtrC

const TText * text = _S("Hello World/n");
TPtrC ptr(text);
// 从一个TPtrC中获得另一个TPtrC
TPtrC p1(ptr);
// 或
TPtrC p2;
p2.Set(ptr);

例4：从TPtrC中获得TText*

// Set the TPtrC
_LIT(KText , "Test Code");
TBufC<10> Buf ( KText );
TPtrC    Ptr1 (Buf);
// 获得TText *
TText * Text1 = (TText *)Ptr1.Ptr();//使用Ptr()方法即可
//从SDK里看到的是const TUint16* Ptr() const;
//然后又能找到typedef unsigned short int TText16;
//呵呵所以说这里可以直接给TText

[edit] TBufC<n>的使用

例1：

// 直接从字符串中构造
_LIT(Ktext, "TestText");
TBufC<10> Buf (Ktext);
// 或
TBufC<10> Buf2;
Buf2 = Ktext;
// 从已有的对象中生成新的TBufC
TBufC<10> Buf3(Buf2);

TBufC<n>一般用来存储文本数据，而TBufC8<n>则用来存储二进制数据。尽管这里的对象表示数据是不能被修改的（因为有个后缀C代表了常量的意思），但仍然有两种方式可以用来修改数据：

这里的数据可以用赋值的方式替换掉。
使用Des()函数构造出一个TPtr对象，这样就可以用它来修改数据

下面是例子： 例1：

_LIT(Ktext , "Test Text");
_LIT(Ktext1 , "Test1Text");
TBufC<10> Buf1 ( Ktext );
TBufC<10> Buf2 ( Ktext1 );
// 通过赋值的方式改变数据
Buf2 = Buf1;
TBufC<10> Buf3;
Buf3 = Buf1;

例2：通过使用Des()改变TBufC的数据

_LIT(Ktext , "Test Text");
_LIT(KXtraText , "New:");
TBufC<10> Buf1 ( Ktext );
TPtr Pointer = Buf1.Des();
// 删除后四个字符
Pointer.Delete(Pointer.Length()-4, 4 );
TInt Len = Pointer.Length();
// 增加新的数据
Pointer.Append(KXtraText);
Len = Pointer.Length();
// 也可以使用下列方式改变数据
_LIT(NewText , "New1");
_LIT(NewText1 , "New2");
TBufC<10> Buf2(NewText);
Pointer.Copy(Buf2);
// 或直接从字符串里获得数据
Pointer.Copy(NewText1);

总结，这里TBufC时，我们通过Des()获得TPtr对象，因此获得了从TDes继承的一系列管理数据的方法。很好：）

[edit] HBufC的使用

当我们不知道数据大小时，我们可以使用它来处理，这里的C表示它是个常量，但同样有两种方式来修改它的数据。第一个是使用赋值操作，另一个也是使用可修改指针型Descriptor，如TPtr。

注意其大小可以通过ReAlloc函数来重新分配。

//有两种方式来生成一个Heap Descriptor
//第一种方式用New(),NewL(),或NewLC()
//如下操作便可以构建一个存放数据的空间，空间为15，不过目前大小//为0
HBufC * Buf = HBufC::NewL(15);

//第二种方式是采用Alloc()，AllocL()或AllcLC()来处理，不过这是已綺存在的数据的管理方式。新的Heap Descriptor可以自动的
根据这个内容来构造。
_LIT (KText , "Test Text");
TBufC<10>  CBuf = KText;
HBufC * Buf1 = CBuf.AllocL();

//下面是通过赋值方式改变其数据的方法
_LIT ( KText1 , "Text1");
*Buf1 = KText1;

// 通过可修改指针来改变数据的方式
TPtr Pointer = Buf1->Des();
Pointer.Delete( Pointer.Length() - 2, 2 );

//这样我们添加删除数据了：）
_LIT ( KNew, "New:");
Pointer.Append( KNew );

[edit] TPtr的使用

通过上面的介绍，我们已綺看到它的使用方式，这里可以看看如何来构造它：

通过另一个TPtr对象
通过TBufC,HBufC的Des()方法获取
通过内存中的确定指针和大小长度来生成

// 通过TBufC来生成
_LIT(KText, "Test Data");
TBufC<10> NBuf ( KText );
TPtr     Pointer = NBuf.Des();

// 通过另一个对象来生成
TPtr     Pointer2 ( Pointer );

//通过指定内存区域和大小来生成
const TText * Text = _S("Test Second");
TPtr    Pointer3 ((TText*)Text ,11, 12);

//改变已有TPtr数据的方式：赋值和Copy()方法
_LIT(K1, "Text1");
_LIT(K2, "Text2");
Pointer2 = K1; // Data will be Text1
Pointer.Copy(K2); // Data Will be Text2;

// 可以改变数据的大小，并置0
Pointer2.SetLength(2); // 只有"Te"了呵呵

[edit] TBuf<n>的使用

这个对象的操作和从TBufC<n>中通过获得TPtr对象的进行的数据操作一样，可以Copy,Delete和赋值等。

[edit] 描述符主要特性

以同样的方式对待字符串和二进制数据。
数据可以存放在内存的任何区域上——ROM或RAM，在堆或栈上都可以。
描述符使用指针和长度信息来描述它包含的数据，有些描述符还包括最大长度的信息。

所有的描述符都是从抽象类TDesC中派生的，他们可以分为三个大类：

缓冲区描述符——数据做为描述符对象的组成部分而存在，描述符对象存放在程序的堆栈中：TBuf和TBufC,
堆描述符——数据做为描述符对象的组成部分而存在，描述符对象存放在堆中：HBufC,
指针描述符——描述符对象和它所表示的实际数据是分开存放的：TPtr和TPtrC.

如果对照C/C++语法来看：

TPtrC可以被看作是const char*的使用
TBufC可以被看作是char[]的使用

其他类没有相应对照语句。

TDes和TDesC是抽象类，因此你不可能实例化它们。它们的主要用途是做为函数的参数来描述字符串和二进制数据。在这样的函数中，你应该按如下规则使用： 1、const TDesC& 表示只读的数据和字符串。 2、TDes& 表示可以被修改的数据和字符串。（我们所看到大多数涉及Descriptor参数的函数和方法都使用了他们来描述）

[edit] Litterals

字符串常量可以使用_L()或_LIT()宏来定义。

_L()可以生成一个指向字符值的地址（TPtrC），它綺常被用来传递字符串到函数中：

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

_LIT()可以生成个常量名，以便以后重复使用：

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

_LIT()宏的结果（就是上面的KMyFile）实际上是个文字描述符（literal descriptor）TLitC，它可以在任何使用TDesC&的地方使用。

用法

TDesC中最常用的函数如下：

Ptr()，用来获得描述符数据中的指针。
Length()，用来获得描述符数据中的字符数。
Size()，用来获得描述符数据中的字节数目。
Cpmpare()或操作符==、!=、>=和<=等专为比较描述符数据用的。
操作符[]，可以被当作c/c++中一样，用来获得描述符字符串中的单个字符。

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