在symbian系统中并没有使用我们熟知的类型和函数来处理字符串和二进制缓冲区,这对于初学者来说可能有点陌生。大概很多编程者都在摸索TBuf, TBufC, HBufC的过程中花费了不少时间……:)
symbian中的描述符(descriptors)主要有以下特性:
1、以同样的方式对待字符串和二进制数据。
2、数据可以存放在内存的任何区域上——ROM或RAM,在堆或栈上都可以。
3、描述符使用指针和长度信息来描述它包含的数据,有些描述符还包括最大长度的信息。
下面这个图示意了描述符相关类的继承关系:
所有的描述符都是从抽象类TDesC中派生的,他们可以分为三个大类:
1、缓冲区描述符——数据做为描述符对象的组成部分而存在,描述符对象存放在程序的堆栈中:TBuf和TBufC,
2、堆描述符——数据做为描述符对象的组成部分而存在,描述符对象存放在堆中:HBufC,
3、指针描述符——描述符对象和它所表示的实际数据是分开存放的:TPtr和TPtrC.
如果对照C/C++语法来看:
1、TPtrC可以被看作是const char*的使用
2、TBufC可以被看作是char[]的使用
其他类没有相应对照语句。
下面显示了各个类中数据是如何组织的:
TDes和TDesC是抽象类,因此你不可能实例化它们。它们的主要用途是做为函数的参数来描述字符串和二进制数据。在这样的函数中,你应该按如下规则使用:
1、const TDesC& 表示只读的数据和字符串。
2、TDes& 表示可以被修改的数据和字符串。
所有这些描述符都可以指定数据尺度:TDes8、TDes16、TDesC8、TDesC16、TBuf8、TBuf16等
这里8表示描述符处理的数据是8bit的,而16表示是16bit数据。一般来说,你只要使用通用形式(TDes, TDesC,...)来表示文本数据而使用8bit版本(TDesC8等)来表示二进制的内容。
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中最常用的函数如下:
1、Ptr(),用来获得描述符数据中的指针。
2、Length(),用来获得描述符数据中的字符数。
3、Size(),用来获得描述符数据中的字节数目。
4、Cpmpare()或操作符==、!=、>=和<=等专为比较描述符数据用的。
5、操作符[],可以被当作c/c++中一样,用来获得描述符字符串中的单个字符。
下面几个函数有其特殊性:
1、Append()和Num()有很多重载形式,具体可以看SDK
2、Compare()有2个变体:CompareC()和CompareF(),以及Copy(),Find(),Locate()和Match(),这些函数都有C/F的后缀形式,C代表Collated而F代表Folded.
Collating和Folding
------------------------
Folding是个比较格式化文本的简单方法,主要用在对比较不是太要求精确的场合。
Collation是个更好的也更有效的比较字符串的方法,可以生成类似字典的顺序。
例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
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继承的一系列管理数据的方法。很好:)
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 );
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"了呵呵
TBuf<n>的使用
这个对象的操作和从TBufC<n>中通过获得TPtr对象的进行的数据操作一样,可以Copy,Delete和赋值等。
描述符主要特性
- 以同样的方式对待字符串和二进制数据。
- 数据可以存放在内存的任何区域上——ROM或RAM,在堆或栈上都可以。
- 描述符使用指针和长度信息来描述它包含的数据,有些描述符还包括最大长度的信息。
所有的描述符都是从抽象类TDesC中派生的,他们可以分为三个大类:
- 缓冲区描述符——数据做为描述符对象的组成部分而存在,描述符对象存放在程序的堆栈中:TBuf和TBufC,
- 堆描述符——数据做为描述符对象的组成部分而存在,描述符对象存放在堆中:HBufC,
- 指针描述符——描述符对象和它所表示的实际数据是分开存放的:TPtr和TPtrC.
如果对照C/C++语法来看:
- TPtrC可以被看作是const char*的使用
- TBufC可以被看作是char[]的使用
其他类没有相应对照语句。
TDes和TDesC是抽象类,因此你不可能实例化它们。它们的主要用途是做为函数的参数来描述字符串和二进制数据。在这样的函数中,你应该按如下规则使用: 1、const TDesC& 表示只读的数据和字符串。 2、TDes& 表示可以被修改的数据和字符串。 (我们所看到大多数涉及Descriptor参数的函数和方法都使用了他们来描述)
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++中一样,用来获得描述符字符串中的单个字符。