·天新网首页·加入收藏·设为首页·网站导航
数码笔记本手机摄像机相机MP3MP4GPS
硬件台式机网络服务器主板CPU硬盘显卡
办公投影打印传真
家电电视影院空调
游戏网游单机动漫
汽车新车购车试驾
下载驱动源码
学院开发设计
考试公务员高考考研
业界互联网通信探索
Symbian开发概述
http://www.21tx.com 2009年11月25日 天极网

  Introduction

  描述符(Descriptors)封装了字符串和二进制数据,用于替代C中的以NULL结尾的字符串。它的长度和数据都封装在了描述符中,Symbian API中用的都是描述符。如:

  TPtrC ptr (KHelloWorld); CEikonEnv::Static()->InfoMsg(ptr);

  Main Types of Descriptors

  主要可以分为以下几类,其中带C的是不可修改的。

  Abstract:(TDes、TDesC),其他描述符的基类,不能实例化,一般用作函数的参数。

  Literal:(TLitC,_LIT()),用于存储literal string,一般使用后者。

  Buffer:(TBuf,TBufC),数据存储于栈上,大小在编译时确定。

  Heap:(HBufC),数据存储于堆上,大小在运行时确定。

  Pointer:(TPtr,TPtrC),引用存储于类之外的数据

  Descriptor Modification

  描述符可以是可修改的和不可修改的,通常带C的都是不可修改的,不可修改的是可修改的基类。

  Moidfiable:提供了访问和修改数据的API,如TBuf

  Non-Modifiable:数据只可以被访问,不可修改。但是通过Des()函数可返回一个可修改的指针

  Descriptor Width

  在描述符类后加上8或者16影响了存储在描述符中的数据的宽度,默认是16位的,处理二进制或ASCII时采用8位。

  8位:(TDesC8),用于二进制数据或者ASCII字符串

  16位:(TDesC16),默认,Unicode

  下面开始对上述5类描述符进行详细介绍,首先看一下类继承关系

  Symbian开发概述

  这里显示的是8位的,16位默认的类继承关系与此一致

  Abstract Descriptors

  除Literal外的所有描述符的基类,提供了基本的接口和基础功能。他们本身不能实例化,一般用作函数参数。

  TDesC:提供了比较、复制、搜索、提取部分字符串的函数。

  TInt TDesCUtil::SUMLengths(const TDesc& aDesC1, const TDesc& aDesC2)

  {

  return aDesC1.Length() + aDesC2.Length();

  }

  TDes:继承自TDesC,添加了许多用于修改数据的函数。其最大长度是描述符被创建时确定的。

  TInt TDesCUtil::AppendL(TDesc& aTarget, const TDesc& aDesC)

  {

  TInt sumLen = aTarget.Length() + aDesC.Length();

  if (aTarget.MaxLength() < sumLen)

  {

  User::Leave(KErrOverflow);

  }

  aTarget.AppendL(aDesC);

  }

  Literal Descriptors

  提供了一种将字符串放在只读存储空间中的机制(实际存放在程序的数据区,而不是真的在ROM中)。一般不采用TLitC而直接采用_LIT()宏。 _LIT(KHelloWorld, "Hello World!");

  通过()操作符可以得到 const TDesC&。 TInt length = KHelloWorld().Length();

  在函数参数为const TDesC&可以直接使用KHelloWorld。iLabel->SetTextL(KHelloWorld);

  Buffer Descriptors

  将数据作为本身的一部分存储在stack上,他们的最大长度是在编译时确定的。

  TBuf<16> helloWorld = KHelloWorld;

  TInt len = KHelloWorld().Length();

  helloWorld[len-1]='?';

  在内存中如下所示:

  Symbian开发概述

  TBufC的用法如下:

  _LIT(KHelloWorld, "Hello World");

  const TInt maxBuf = 32;

  TBufC buf;

  TInt currentLen = buf.Length(); // == 0

  buf = KHelloWorld;

  currentLen = buf.Length(); // == 11

  TText ch = buf[2]; // == 'l'

  TBuf的用法如下:

  const TInt bufLen = 6;

  TUInt8 objType = 1;

  TUInt8 objId = 1;

  TUInt8 xCoord = 128;

  TUInt8 yCoord = 192;

  ....

  TBuf8 buf;

  buf.Append(objType);

  buf.Append(objId);

  ...

  //we can now do something with the buffer such as writting it to a binary file or send via socket.

  Pointer Descriptor

  用于引用存储在其他地方的数据,如:

  const unsigned char KBuffer[ ] = {0x00, 0x33, 0x66, 0x99, 0xbb, 0xff};

  TPtrC8 buffERPtr( KBuffer, sizeof(KBuffer));

  iSocket.Write(bufferPtr, iStatus);

  在内存中如下所示:

  Symbian开发概述

  TPtr的用法:

  _LIT(KHelloWorld, "Hello World");

  const TInt maxBuf = 32;

  TBufC buf;

  buf = KHelloWorld;

  TPtr ptr = buf.Des();

  ptr[7] = 'a'; ptr[8] = 'l'; ptr[9] = 'e'; ptr[10] = 's';

  CEikonEnv::Static()->InfoMsg(ptr); // "Hello Wales"

  Heap Descriptors

  动态在堆(heap)上分配,通过HBufC的API,数据可以被set和reset,但是不能被修改。如:

  HBufC* heaPBuf = HBufC::NewL(KHelloWorld().Length());

  *heapBuf = KHelloWorld();

  delete heapBuf;

  在内存中的情况如下图所示:

  Symbian开发概述

  HBufC通常在以下几种情况下使用:

  在运行时从资源文件中加载字符串

  从用户界面中接收用户输入的字符串

  从应用程序引擎中接收字符串,如contacts database中的名字

  对HBufC中的内容进行修改:

  _LIT(KHello, "Hello!");

  _LIT(KWorld, "World!");

  HBufC* heapBuf = HBufC::NewL(KHello().Length());

  *heapBuf = KHello; //buf holds "Hello!"

  heapBuf = heapBuf->ReAllocL(KHello().Length() + KWorld().Length());

  CleanupStack::PushL(heapBuf);

  TPtr ptr (heapBuf->Des()); //DON'T use TPtr ptr = heapBuf->Des(); this will set maxlen to 6 but not 12...

  ptr[KHello().Length() - 1] = ' ';

  ptr += KWorld;

  iTopLabel -> SetTextL(ptr);

  CleanupStack::PopAndDestroy();

  DrawNow();

  下面介绍Descriptors的具体用法:

  Non-Modifying Methods

  Length(),Size(),Left(),Right(),Mid(),Compare(),Locate(),LocateReverse (),Find(),Match()等。以下代码示例描述了如何在一个descriptor中找到<>中的内容,如果不存在,返回整个字符 串:

  static const TUint KAddressStartChar = '<';

  static const TUint KAddressEndChar = '>';

  TPtrC ExtractAddressNumber( const TDesC& aAddressString)

  {

  TInt addrStart = aAddressString.Locate(KAddressStartChar ) + 1;

  TInt addrEnd = aAddressString.LocateReverse(KAddressEndChar ) ;

  if ((addrStart == KErrNotFound) || (addrEnd == KErrNotFound) || (addrStart >= addrEnd) )

  {

  addrStart = 0;

  addEnd = aAddressString.Length();

  }

  return (aAddressString.Mid(addrStart, (addrEnd - addrStart) ) );

  }

  Modifying Methods

  Zero(),Copy(),Num(),Format(),Insert(),Replace(),Delete(),Append(),Trim()等。代码示例:

  _LIT(KText, "Hello World!");

  _LIT(KNewText, "New Text");

  _LIT(KReplaced, "Replaced");

  TBuf<16> buf1(KText);

  buf1.Delete(6, 6); // length is now 6, leaving "Hello" in the buffer

  TBuf<16> buf2(KNewText);

  buf2.Copy(KReplaced); // buf2 now contains "Replaced"

  buf2.Append(KNewText); //buf2 now contains "Replaced New Text"

  buf2.Delete(99, 1); //Will Cause a PANIC!!!

  Descriptors in Method Declarations

  在函数参数中尽量使用基类

  使用中性的描述符,一般情况下使用TDesC而不是TDesC8或者TDesC16

  当描述符内容不应该改变时,使用const修饰符

  经典用法:void SetText(const TDesC& aText); TPtrC Text() const;

  Character Conversions

  CCnVCharacterSetConverter类提供了在Unicode和其他字符集编码之间转换的方法。

  ASCII本来就是Unicode的一个子集,无须使用该类。和Unicode之间的转换方法如下所示:

  TBuf16<64> UnicodeBuf;

  _LIT8(KAsciiStr, "Hello");

  UnicodeBuf.Copy(KAsciiStr);

  Unicode和拉丁语系之间的转化可使用如下的代码:

  TBuf8<64> Latin1Buf;

  _LIT16(KUnicodeStr1, "hello");

  _LIT16(KUnicodeStr2, "I have got 10\x20AC."); //\x20AC is a euro

  Latin1Buf.Copy(KUnicodeStr1); //OK

  Latin1Buf.Copy(KUnicdoeStr2); //Not as you wanted.

上一篇: Symbian内存管理
下一篇: Symbian C++ 各种类型之间的转换

关于我们 | 联系我们 | 加入我们 | 广告服务 | 投诉意见 | 网站导航
Copyright © 2000-2011 21tx.com, All Rights Reserved.
晨新科技 版权所有 Created by TXSite.net