译自Developer Library » Symbian OS Guide » Essential idioms » Descriptors
概要
描述符既是Symbian OS中基本的东西,同时也是比较非面向对象(non-OO)和面向对象(OO)设计方法的极好的例子。
在C语言中字符串是下面这样的:
char *hello = “hello”;
上面的语句使设置一些内存使其包含‘h’,‘e’,‘l’,‘l’,‘o’,‘\0’6个字符。strlen()函数从开始字节扫描内存直到以空字符(‘\0’)结尾。如果你想扩展字符串,你需要知道给它分配了多少内存。
描述符抽象
通过两个抽象类表示出字符串的基本需要:TDesC和TDes。
TDesC是常量的或者说不可修改的描述符,它包含有地址和长度信息。在下面的情况下可以使用这个类:需要对数据做许多操作但不需要更改它,因此TDesC提供了许多不修改数据的函数。
TDes是可修改的描述符,它另外包含有最大长度信息,它允许数据扩展或减小(只要不超过最大长度),因此,TDes提供许多可以修改数据的函数。
描述符的基本特征是修改操作不可以超出已经分配的长度,但有一些类允许这样做,例如CBufBase和它的派生类。如果一个TDes函数引发溢出将会产生系统错误(panic)。
因为TDesC和TDes包含了所有函数需要的访问、操作字符串和内存数据的功能,所以许多只需要访问数据的函数用const TDesC&做为参数,那些需要修改数据的函数用TDes&做为参数。
指针描述符
抽象描述符类有多种实现,其中最简单的就是指针描述符。
TPtrC仅仅包含长度与地址信息:它只需要两个机器字来表示。TPtrC可以被设置为表示任何现存的数据。TPtr增加了最大长度信息,因此它可以用来表示那些未完全分配的缓冲区(buffer)。
图
TPtrC和TPtr与C语言中的char*有点儿类似,但因为描述符自己包含了长度信息,所以不再需要扫描结尾的空字符(‘\0’)或为它分配空间。
缓冲器描述符
缓冲器描述符TBufC和TBuf中的数据就是自己的一部分,就像C语言中的字符数组(char[])。
图
这种描述符使用C++的模板机制,通过一个整数参数指出缓冲器长度。
堆描述符
堆描述符HbufC包含的数据是存放在堆上的。
图
这就像C语言中的(char*)malloc( length+1 )一样通常用于预先不能确定长度的情况。因为是在堆上分配的,它总是通过HBufC*使用而不是直接定义HBufC对象。
描述符类
下面是完整的描述符类层次图:
上图体现出了使用面向对象的优雅性。TBufCBase只是为了考虑实现的方便性,这也是面向对象中常有的习惯(然而它需要小心使用)。
描述符使得表示串行数据变的简单。当描述符用于字符串时,应该使用TDes(TDesC,TBuf…)等等,因为在Unicode编译条件下,这些类通过typedef定义为TDes16(TDesC16,TBuf16…)等等。
因为描述符可以包含任何数据,包括空字符,所以它可以被用来引用字节数据和普通缓冲器。在需要8位数据的情况下(无论是什么编译条件,有可能是Unicode编译条件),你应该总是直接使用TDes8等形式。