Class RStringBase

class RStringBase;

Description

Base class for classes that represent a string in a string pool.

There are sub-classes for folded and non-folded strings. Use this class when you want to receive a string, but have no intention of comparing it with anything.

Members

Defined in RStringBase:

• Close()Closes a string.
• Copy()Copies a string.
• DesC()constGets the content of the string.
• Index(const TStringTable &)constGets the enumeration value corresponding to this string.
• OriginalTableRef()constGets the table (if any) that first added the current string to the pool.
• Pool()constGets the string pool.
• RStringBase()Default constructor.
• iPool
• iVal
• operator RStringTokenBase()constReturns a compact string equivalent to the string

See also:

• RStringPoolString pool handle.

inline RStringBase();

Description

Default constructor.

IMPORT_C void Close();

Description

Closes a string.

You must close every string you open. In other words, every call to RStringBase::Copy(), RStringPool::OpenStringL(const TDesC8 &)const and RStringPool::OpenFStringL(const TDesC8 &)const must be matched by a close.

Strings created through RStringPool::String(RStringToken)const or RStringPool::StringF(RStringTokenF)const with an integer argument need not be closed (but closing is harmless).

Strings created through RStringPool::String(RStringToken)const or RStringPool::StringF(RStringTokenF)const with a StringToken or StringTokenF argument must not be closed, as they're just changing the external representation.

IMPORT_C RStringBase Copy();

Description

Copies a string.

Both the original and the copy string must be separately closed.

Return value

IMPORT_C const TDesC8& DesC() const;

Description

Gets the content of the string.

Return value

inline operator RStringTokenBase() const;

Description

Returns a compact string equivalent to the string

Return value

IMPORT_C TInt Index(const TStringTable &aTable) const;

Description

Gets the enumeration value corresponding to this string.

Parameters

Return value

Panic codes

IMPORT_C const TStringTable* OriginalTableRef() const;

Description

Gets the table (if any) that first added the current string to the pool.

Note there multiple tables can contain the same string.

Return value

inline RStringPool Pool() const;

Description

Gets the string pool.

Return value

protected: RStringPool iPool;

Description

protected: TUint32 iVal;

Description