我翻译的文档----Symbian基本规范:描述符

译自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等形式。