class TDes8 : public TDesC8 |
Abstract base class for 8-bit modifiable descriptors.
The class encapsulates the data member containing the maximum length of data represented by an 8-bit descriptor. It also provides member functions through which the data can be modified.
The class adds to the behaviour provided by TDesC8.
This class cannot be instantiated as it is intended to form part of a class hierarchy; it provides a well defined part of descriptor behaviour. It can, however, be passed as an argument type for functions which need to both modify and access descriptor data.
Public Member Functions | |
---|---|
IMPORT_C void | Append(TChar) |
IMPORT_C void | Append(const TDesC8 &) |
IMPORT_C void | Append(const TDesC16 &) |
IMPORT_C void | Append(const TUint8 *, TInt) |
IMPORT_C void | AppendFill(TChar, TInt) |
IMPORT_C void | AppendFormat(TRefByValue< const TDesC8 >, TDes8Overflow *, ...) |
IMPORT_C void | AppendFormat(TRefByValue< const TDesC8 >, ...) |
IMPORT_C void | AppendFormatList(const TDesC8 &, VA_LIST, TDes8Overflow *) |
IMPORT_C void | AppendJustify(const TDesC8 &, TInt, TAlign, TChar) |
IMPORT_C void | AppendJustify(const TDesC8 &, TInt, TInt, TAlign, TChar) |
IMPORT_C void | AppendJustify(const TUint8 *, TInt, TAlign, TChar) |
IMPORT_C void | AppendJustify(const TUint8 *, TInt, TInt, TAlign, TChar) |
IMPORT_C void | AppendNum(TInt64) |
IMPORT_C void | AppendNum(TUint64, TRadix) |
IMPORT_C TInt | AppendNum(TReal, const TRealFormat &) |
IMPORT_C void | AppendNumFixedWidth(TUint, TRadix, TInt) |
IMPORT_C void | AppendNumFixedWidthUC(TUint, TRadix, TInt) |
IMPORT_C void | AppendNumUC(TUint64, TRadix) |
IMPORT_C void | Capitalize() |
IMPORT_C void | Collapse() |
IMPORT_C void | Collate() |
IMPORT_C void | Copy(const TDesC8 &) |
IMPORT_C void | Copy(const TUint8 *, TInt) |
IMPORT_C void | Copy(const TUint8 *) |
IMPORT_C void | Copy(const TDesC16 &) |
IMPORT_C void | CopyC(const TDesC8 &) |
IMPORT_C void | CopyCP(const TDesC8 &) |
IMPORT_C void | CopyF(const TDesC8 &) |
IMPORT_C void | CopyLC(const TDesC8 &) |
IMPORT_C void | CopyUC(const TDesC8 &) |
IMPORT_C void | Delete(TInt, TInt) |
IMPORT_C TPtr16 | Expand() |
IMPORT_C void | Fill(TChar) |
IMPORT_C void | Fill(TChar, TInt) |
IMPORT_C void | FillZ() |
IMPORT_C void | FillZ(TInt) |
IMPORT_C void | Fold() |
IMPORT_C void | Format(TRefByValue< const TDesC8 >, ...) |
IMPORT_C void | FormatList(const TDesC8 &, VA_LIST) |
IMPORT_C void | Insert(TInt, const TDesC8 &) |
IMPORT_C void | Justify(const TDesC8 &, TInt, TAlign, TChar) |
IMPORT_C TPtr8 | LeftTPtr(TInt) |
IMPORT_C void | LowerCase() |
TInt | MaxLength() |
TInt | MaxSize() |
IMPORT_C TPtr8 | MidTPtr(TInt) |
IMPORT_C TPtr8 | MidTPtr(TInt, TInt) |
IMPORT_C void | Num(TInt64) |
IMPORT_C void | Num(TUint64, TRadix) |
IMPORT_C TInt | Num(TReal, const TRealFormat &) |
IMPORT_C void | NumFixedWidth(TUint, TRadix, TInt) |
IMPORT_C void | NumFixedWidthUC(TUint, TRadix, TInt) |
IMPORT_C void | NumUC(TUint64, TRadix) |
IMPORT_C const TUint8 * | PtrZ() |
IMPORT_C void | Repeat(const TUint8 *, TInt) |
IMPORT_C void | Repeat(const TDesC8 &) |
IMPORT_C void | Replace(TInt, TInt, const TDesC8 &) |
IMPORT_C TPtr8 | RightTPtr(TInt) |
IMPORT_C void | SetLength(TInt) |
IMPORT_C void | SetMax() |
IMPORT_C void | Swap(TDes8 &) |
IMPORT_C void | Trim() |
IMPORT_C void | TrimAll() |
IMPORT_C void | TrimLeft() |
IMPORT_C void | TrimRight() |
IMPORT_C void | UpperCase() |
IMPORT_C void | Zero() |
IMPORT_C void | ZeroTerminate() |
TDes8 & | operator+=(const TDesC8 &) |
TDes8 & | operator=(const TUint8 *) |
TDes8 & | operator=(const TDesC8 &) |
TDes8 & | operator=(const TDes8 &) |
const TUint8 & | operator[](TInt) |
TUint8 & | operator[](TInt) |
Protected Member Functions | |
---|---|
TDes8(TInt, TInt, TInt) | |
TDes8() | |
void | DoAppendNum(TUint64, TRadix, TUint, TInt) |
void | DoPadAppendNum(TInt, TInt, const TUint8 *) |
TUint8 * | WPtr() |
Protected Attributes | |
---|---|
__DECLARE_TEST | |
TInt | iMaxLength |
IMPORT_C void | AppendFormat | ( | TRefByValue< const TDesC8 > | aFmt, |
TDes8Overflow * | aOverflowHandler, | |||
... | ||||
) |
TRefByValue< const TDesC8 > aFmt | |
TDes8Overflow * aOverflowHandler | |
... |
IMPORT_C void | AppendFormat | ( | TRefByValue< const TDesC8 > | aFmt, |
... | ||||
) |
TRefByValue< const TDesC8 > aFmt | |
... |
IMPORT_C void | AppendFormatList | ( | const TDesC8 & | aFmt, |
VA_LIST | aList, | |||
TDes8Overflow * | aOverflowHandler = NULL | |||
) |
const TDesC8 & aFmt | |
VA_LIST aList | |
TDes8Overflow * aOverflowHandler = NULL |
IMPORT_C void | AppendJustify | ( | const TDesC8 & | Des, |
TInt | aWidth, | |||
TAlign | anAlignment, | |||
TChar | aFill | |||
) |
IMPORT_C void | AppendJustify | ( | const TDesC8 & | Des, |
TInt | aLength, | |||
TInt | aWidth, | |||
TAlign | anAlignment, | |||
TChar | aFill | |||
) |
IMPORT_C void | AppendJustify | ( | const TUint8 * | aString, |
TInt | aWidth, | |||
TAlign | anAlignment, | |||
TChar | aFill | |||
) |
IMPORT_C void | AppendJustify | ( | const TUint8 * | aString, |
TInt | aLength, | |||
TInt | aWidth, | |||
TAlign | anAlignment, | |||
TChar | aFill | |||
) |
IMPORT_C TInt | AppendNum | ( | TReal | aVal, |
const TRealFormat & | aFormat | |||
) |
TReal aVal | |
const TRealFormat & aFormat |
IMPORT_C void | AppendNumFixedWidth | ( | TUint | aVal, |
TRadix | aRadix, | |||
TInt | aWidth | |||
) |
IMPORT_C void | AppendNumFixedWidthUC | ( | TUint | aVal, |
TRadix | aRadix, | |||
TInt | aWidth | |||
) |
void | DoAppendNum | ( | TUint64 | aVal, |
TRadix | aRadix, | |||
TUint | aA, | |||
TInt | aW | |||
) | [protected] |
void | DoPadAppendNum | ( | TInt | aLength, |
TInt | aW, | |||
const TUint8 * | aBuf | |||
) | [protected] |
IMPORT_C void | Format | ( | TRefByValue< const TDesC8 > | aFmt, |
... | ||||
) |
TRefByValue< const TDesC8 > aFmt | |
... |
IMPORT_C void | Justify | ( | const TDesC8 & | aDes, |
TInt | aWidth, | |||
TAlign | anAlignment, | |||
TChar | aFill | |||
) |
TInt | MaxLength | ( | ) | const [inline] |
Gets the maximum length of the descriptor.
This is the upper limit for the number of 8-bit values or data items that the descriptor can represent.
The maximum length of data that the descriptor can represent.
TInt | MaxSize | ( | ) | const [inline] |
Gets the maximum size of the descriptor.
This is the upper limit for the number of bytes which the data represented by the descriptor can occupy.
The maximum size of the descriptor data.
IMPORT_C TInt | Num | ( | TReal | aVal, |
const TRealFormat & | aFormat | |||
) |
TReal aVal | |
const TRealFormat & aFormat |
IMPORT_C void | NumFixedWidthUC | ( | TUint | aVal, |
TRadix | aRadix, | |||
TInt | aWidth | |||
) |
IMPORT_C void | Replace | ( | TInt | aPos, |
TInt | aLength, | |||
const TDesC8 & | aDes | |||
) |
TDes8 & | operator+= | ( | const TDesC8 & | aDes | ) | [inline] |
Appends data onto the end of this descriptor's data and returns a reference to this descriptor.
The length of this descriptor is incremented to reflect the new content.
A reference to this descriptor.
panic
USER 23, if the resulting length of this descriptor is greater than its maximum length.
const TDesC8 & aDes | An-8 bit non-modifiable descriptor whose data is to be appended. |
TDes8 & | operator= | ( | const TUint8 * | aString | ) | [inline] |
Copies data into this descriptor replacing any existing data.
The length of this descriptor is set to reflect the new data.
A reference to this, the target descriptor.
panic
USER 23, if the length of the string, excluding the zero terminator, is greater than the maximum length of this (target) descriptor.
const TUint8 * aString | A pointer to a zero-terminated string. |
TDes8 & | operator= | ( | const TDesC8 & | aDes | ) | [inline] |
Copies data into this descriptor replacing any existing data.
The length of this descriptor is set to reflect the new data.
A reference to this, the target descriptor.
panic
USER 23, if the length of the descriptor aDes is greater than the maximum length of this (target) descriptor.
const TDesC8 & aDes | An 8-bit non-modifiable descriptor. |
TDes8 & | operator= | ( | const TDes8 & | aDes | ) | [inline] |
Copies data into this descriptor replacing any existing data.
The length of this descriptor is set to reflect the new data.
A reference to this, the target descriptor.
panic
USER 23, if the length of the descriptor aDes is greater than the maximum length of this (target) descriptor.
const TDes8 & aDes | An 8-bit modifiable descriptor. |
const TUint8 & | operator[] | ( | TInt | anIndex | ) | const [inline] |
Gets a const reference to a single data item within this descriptor's data.
A const reference to the data item at the specified position.
panic
USER 21, if anIndex is negative or is greater than or equal to the current length of this descriptor.
TInt anIndex | The position of the data item within this descriptor's data. This is an offset value; a zero value refers to the leftmost data position. |
TUint8 & | operator[] | ( | TInt | anIndex | ) | [inline] |
Gets a non-const reference to a single data item within this descriptor's data.
A non-const reference to the data item at the specified position.
panic
USER 21, if anIndex is negative or is greater than or equal to the current length of this descriptor.
TInt anIndex | The position of the data item within this descriptor's data. This is an offset value; a zero value refers to the leftmost data position. |