Chinaunix首页 | 论坛 | 博客
  • 博客访问: 349159
  • 博文数量: 42
  • 博客积分: 1896
  • 博客等级: 上尉
  • 技术积分: 615
  • 用 户 组: 普通用户
  • 注册时间: 2007-06-19 14:47
文章分类

全部博文(42)

文章存档

2012年(1)

2011年(21)

2010年(16)

2009年(4)

分类: C/C++

2010-06-04 10:02:04

概述

    Resizable buffer描述符是一个RBuf类型。这个描述符是最近才添加到描述符大家庭的,和其他描述符类型一样,用于包含字符串和二进制数据。通过这个描述符继 承基类的成员函数可以访问和修改数据,描述符的数据分配在堆上,但数据不属于描述符的一部分。

    一般的用法是:当很少修改数据时,使用HBufC类型;当需要频繁修改数据时,使用RBuf类型。然而,在实际中RBuf同时适用于这两种情况,并且应该 优先使用RBuf类型。

    关于描述符的一些重点:

    对于文本数据,常用RBuf类型;对于二进制数据,显式使用RBuf8类型;极少显式使用RBuf16类型。数据据能够通过RBuf和赋值操作符进行修 改。在传递参数时,可以向形参为TDesC&和TDes&类型的函数传递RBuf类型。代码中已经分配的内存可以转移给RBuf,这允许 任何区域的内存能够通过RBuf进行操作。已经存在的HBufC对象的所有权也能转移给RBuf。这允许包含在HBufC中的数据可以通过RBuf操作。

创建RBuf

    RBuf对象可以在栈上创建,也可以作为‘C’类型类的成员函数,但不能作为‘T’类型类的成员函数。

    IMPORT_C RBuf();

    缺省的构造函数没有分配缓冲区,意味着对象没有数据,描述符的长度和最大长度都是0。

    在描述符处理数据之前,必须要创建缓冲区。

1、最简单创建RBuf方法:

    IMPORT_C TInt Create(TInt aMaxLength);

    IMPORT_C void CreateL(TInt aMaxLength);

    参数指定了创建缓冲区的最大长度,但描述符的数据为空,长度为0。

    IMPORT_C TInt CreateMax(TInt aMaxLength);

    IMPORT_C void CreateMaxL(TInt aMaxLength);

    参数指定了创建缓冲区的最大长度,同时将数据长度也设置为同一个值,缓冲区中数据将添加任意值。

2、通过已存在的描述符创建RBuf:

    IMPORT_C TInt Create(const TDesC &aDes);

    IMPORT_C void CreateL(const TDesC &aDes);

    创建一个缓冲区,将指定的已存在的描述符对象的数据复制到缓冲区中。RBuf的最大长度和长度与指定的描述符一致。

    IMPORT_C TInt Create(const TDesC &aDes, TInt aMaxLength);

    IMPORT_C TInt CreateL(const TDesC &aDes, TInt aMaxLength);

    创建一个缓冲区,将指定的已存在的描述符对象的数据复制到缓冲区中。当复制的数据长度小于aMaxLength时,将完全复制,RBuf的长度为描述符的 长度;当大于时,将部分复制,RBuf的长度为aMaxLength。

3、通过将已分配内存的所有权转移来创建RBuf:

    一个创建RBuf的重要技术就是将已分配的内存的所有权转移给RBuf。这意味着允许RBuf能处理任何内存区域。

    1)转移HBuf的所有权给RBuf:

    IMPORT_C RBuf(HBufC *aHBuf);

    通过构造函数来获得HBuf的所有权。

    IMPORT_C void Assign(HBufC *aHBuf);

    在创建了RBuf对象后,通过成员函数来获得HBuf的所有权。

    一旦转移了所有权,就不能通过HBuf对数据进行访问了。而释放内存也必须由RBuf来完成。

    2)转移已分配内存的所有权给RBuf:

    IMPORT_C void Assign(TUint *aHeapCell, TInt aMaxLength);

    IMPORT_C void Assign(TUint *aHeapCell, TInt aLength, TInt aMaxLength);

    3)转移另一个RBuf对象的所有权给当前RBuf:

    IMPORT_C void Assign(const RBuf &aRBuf);

重新分配缓冲区

    IMPORT_C TInt ReAlloc(TInt aMaxLength);

    IMPORT_C void ReAllocL(TInt aMaxLength);

    无论初始的缓冲区是分配的还是通过转移所有权来的,都可进行重新分配。但重新分配的最大长度不能小于数据长度。

释放缓冲区

    当已分配的RBuf对象不在使用时,必须释放分配的缓冲区,防止内存泄漏。可以使用ReAlloc(0)和 ReAllocL(0)函数传递参数零来释放缓冲区内存。

    IMPORT_C void Close();

    标准的释放内存的成员函数,将已分配的内存释放,并将描述符的长度设为0。

清理规则

    当RBuf对象分配在栈上时,为了防止在分配堆缓冲区异常退出而导致内存泄漏,需要在分配堆缓冲区前将RBuf对象推入清理栈中。当描述符对象异常退出 时,调用Close()释放缓冲区。最后需要将RBuf对象从清理栈中弹出。

    IMPORT_C void CleanupClosePushL();

阅读(1078) | 评论(0) | 转发(0) |
0

上一篇:C++类型转换

下一篇:S60基本程序框架

给主人留下些什么吧!~~