Symbian学习笔记5 之 Descriptors

在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&的地方使用。

注意： 它是一个Const，参数传递的时候要注意形参是否有const

           从e32des16.h头文件里，我们可以看到 TBufC16里的字符串格式是 TUint16 iBuf[__Align16(S)];，相当于char[]，而TPtr16里的字符串格式是TUint16 *iPtr;，相当于 char *

           另外 console->Printf(format, content);format 要用_L(format)的形式或者 _LIT(format, format_content)的形式去使用，不用直接使用一个字符串

          我们看Printf的函数原型：

IMPORT_C void Printf(TRefByValue aFmt,...);

这是TRefByValue类的原型：

template
class TRefByValue
    {
public:
    inline TRefByValue(T& aRef);
    inline operator T&();
private:
    TRefByValue& operator=(TRefByValue aRef);
private:
    T &iRef;
    };

我们不管TRefByValue是做什么的，看Printf的函数声明 ，可以判定aFmt参数是TDesC型的，而"string"是 const char[] 型，而TDesC它的字符串不是真正意义上的const字符串，而只是没有提供修改字符串的接口，所以它的字符串类型仍然是char[] 或者TUInt16*的，不是const型，所以在使用console->Printf()的时候类型就不匹配，导致错误

           
用法
---------
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是个更好的也更有效的比较字符串的方法，可以生成类似字典的顺序。