Class TPtrC8

TPtrC8

Support

Supported from 5.0

Description

8 bit non-modifiable pointer descriptor

This is a descriptor class intended for instantiation and encapsulates a pointer to the 8 bit data that it represents. The data can live in ROM or RAM and this location is separate from the descriptor object itself.

The data is intended to be accessed, but not changed, through this descriptor. The base class provides the functions through which data is accessed.

Derivation

TDesC8 Abstract base class for 8 bit non-modifiable descriptors TPtrC8 8 bit non-modifiable pointer descriptor

Defined in TPtrC8:
Set(), TPtrC8()

Inherited from TDesC8:
Alloc(), AllocL(), AllocLC(), Compare(), CompareC(), CompareF(), Find(), FindC(), FindF(), Left(), Length(), Locate(), LocateF(), LocateReverse(), LocateReverseF(), Match(), MatchC(), MatchF(), Mid(), Ptr(), Right(), Size(), operator!=(), operator<(), operator<=(), operator==(), operator>(), operator>=(), operator[]()

See also:

• TPtr8
• TDesC8
• TDes8
• TBufC8
• TBuf8
• HBufC8

TPtrC8();

Description

Default constructor.

Constructs an empty 8 bit non-modifiable pointer descriptor. It represents no data and its length is zero.

The non-modifiable pointer descriptor can, subsequently, be set to represent data.

See also:

• TPtrC8::Set()

TPtrC8(const TPtrC8& aDes);

Description

Copy constructor.

Constructs the 8 bit non-modifiable pointer descriptor from an existing non-modifiable pointer descriptor.

It is set to point to the same data and is given the same length as the source non-modifiable pointer descriptor.

Parameters

const TPtrC8& aDes The source 8 bit non-modifiable pointer descriptor.

TPtrC8(const TDesC8& aDes);

Description

Constructs the 8 bit non-modifiable pointer descriptor from any existing descriptor.

It is set to point to the same data and is given the same length.

Parameters

const TDesC8& aDes A reference to an 8bit non-modifiable descriptor.

TPtrC8(const TUint8* aString);

Description

Constructs the 8 bit non-modifiable pointer descriptor to point to a zero terminated string, whether in RAM or ROM.

The length of the descriptor is set to the length of the zero terminated string, excluding the zero terminator.

Parameters

const TUint8* aString A pointer to a zero terminated string.

TPtrC8(const TUint8* aBuf,TInt aLength);

Description

Constructs the 8 bit non-modifiable pointer descriptor to point to the the specified location in memory, whether in RAM or ROM. The length of the descriptor is set to the specified length.

Parameters

const TUint8* aBuf A pointer to the location that the descriptor is to represent. TInt aLength The length of the descriptor. This value must be non-negative otherwise the constructor raises a USER 29 panic.

void Set(const TDesC8& aDes);

Description

Sets the 8 bit non-modifiable pointer descriptor from the specified descriptor.

It is set to point to the same data and is given the same length.

Parameters

const TDesC8& aDes A reference to an 8 bit non-modifiable descriptor

void Set(const TUint8* aBuf,TInt aLength);

Description

Sets the 8 bit non-modifiable pointer descriptor to point to the specified location in memory, whether in RAM or ROM. The length of the descriptor is set to the specified length.

Parameters

const TUint8* aBuf A pointer to the location that the descriptor is to represent. TInt aLength The length of the descriptor. This value must be non-negative otherwise the constructor raises a USER 29 panic.