Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: e32des8.h

Class TBuf8

class TBuf8 : public TBufBase8;

Description

A descriptor class which provides a buffer of fixed length for containing, accessing and manipulating TUint8 data.

The class is intended for instantiation. The 8-bit data that the descriptor represents is part of the descriptor object itself.

The class is templated, based on an integer value which determines the size of the data area which is created as part of the buffer descriptor object; this is also the maximum length of the descriptor.

The data is intended to be both accessed and modified. The base classes provide the functions through which the data is accessed.

Derivation

Members

Defined in TBuf8:
TBuf8(), TBuf8(), TBuf8(), TBuf8(), iBuf, operator=(), operator=(), operator=()

See also:


Construction and destruction


TBuf8()

inline TBuf8();

Description

Constructs an empty 8-bit modifiable buffer descriptor.

It contains no data.

The integer template parameter determines the size of the data area that is created as part of the object, and defines the descriptor's maximum length.


TBuf8()

inline TBuf8(TInt aLength);

Description

Constructs an empty 8-bit modifiable buffer descriptor and sets the its length to the specified value.

No data is assigned to the descriptor.

The integer template parameter determines the size of the data area that is created as part of the object, and defines the descriptor's maximum length.

Parameters

TInt aLength

The length of this modifiable buffer descriptor.

Panic codes

USER

20, if aLength is negative or is greater than the value of the integer template parameter.


TBuf8()

inline TBuf8(const TUint8 *aString);

Description

Constructs the 8-bit modifiable buffer descriptor from a zero terminated string.

The integer template parameter determines the size of the data area that is created as part of the object, and defines the descriptor's maximum length.

The string, excluding the zero terminator, is copied into this buffer descriptor's data area. The length of this buffer descriptor is set to the length of the string, excluding the zero terminator.

Parameters

const TUint8 *aString

A pointer to a zero terminated string.

Panic codes

USER

23, if the length of the string, excluding the zero terminator, is greater than the value of the integer template parameter.


TBuf8()

inline TBuf8(const TDesC8 &aDes);

Description

Constructs the 8-bit modifiable buffer descriptor from any existing 8-bit descriptor.

The integer template parameter determines the size of the data area created as part of this object and defines the descriptor's maximum length.

Data is copied from the source descriptor into this modifiable buffer descriptor and the length of this modifiable buffer descriptor is set to the length of the source descriptor.

Parameters

const TDesC8 &aDes

The source 8-bit non-modifiable descriptor.

Panic codes

USER

23, if the length of the source descriptor is greater than the value of the integer template parameter.

[Top]


Member functions


operator=()

inline TBuf8< S > &operator=(const TUint8 *aString);

Description

Copies data into this 8-bit modifiable buffer descriptor, replacing any existing data.

The length of this descriptor is set to reflect the new data.

Parameters

const TUint8 *aString

A pointer to a zero-terminated string.

Return value

TBuf8< S > &

A reference to this 8-bit modifiable buffer descriptor.

Panic codes

USER

23, if the length of the string, excluding the zero terminator, is greater than the maximum length of this (target) descriptor.


operator=()

inline TBuf8< S > &operator=(const TDesC8 &aDes);

Description

Copies data into this 8-bit modifiable buffer descriptor, replacing any existing data.

The length of this descriptor is set to reflect the new data.

Parameters

const TDesC8 &aDes

An 8 bit non-modifiable descriptor.

Return value

TBuf8< S > &

A reference to this 8-bit modifiable buffer descriptor.

Panic codes

USER

23, if the length of the descriptor aDes is greater than the maximum length of this (target) descriptor.


operator=()

inline TBuf8< S > &operator=(const TBuf8< S > &aBuf);

Description

Copies data into this 8-bit modifiable buffer descriptor replacing any existing data.

The length of this descriptor is set to reflect the new data.

Parameters

const TBuf8< S > &aBuf

The source 8-bit modifiable buffer descriptor with the same template value.

Return value

TBuf8< S > &

A reference to this 8-bit modifiable buffer descriptor.

[Top]


Member data


iBuf

protected: TUint8 iBuf;

Description