Class RTextBuf

class RTextBuf;

Description

A simple class that encapsulates a text string.

As with the descriptor classes, the class sets a maximum length for the encapsulated string, which cannot be exceeded. The class might be preferred to a descriptor in some circumstances as its maximum length can be increased (unlike a TBuf), and it can be created on the stack (unlike an HBufC) .

Members

Defined in RTextBuf:

• Close()
• MaxLength()constGets the maximum length of the text.
• RTextBuf()Default constructor.
• SetMaxLengthL(TInt)Sets the maximum length of the text that the object can store.
• SetText(const TDesC &)Sets the text. You must have set the maximum length appropriately first with RTe...
• Text()Gets the text as a descriptor.
• Text()constGets the text as a descriptor.
• ~RTextBuf()Destructor.

IMPORT_C RTextBuf();

Description

Default constructor.

IMPORT_C ~RTextBuf();

Description

Destructor.

inline TPtr& Text();

Description

Gets the text as a descriptor.

Return value

inline const TPtr& Text() const;

Description

Gets the text as a descriptor.

Return value

inline TInt MaxLength() const;

Description

Gets the maximum length of the text.

Return value

inline void SetText(const TDesC &aDes);

Description

Sets the text. You must have set the maximum length appropriately first with RTextBuf::SetMaxLengthL(TInt).

Parameters

IMPORT_C void SetMaxLengthL(TInt aMaxLength);

Description

Sets the maximum length of the text that the object can store.

Attempts to store text beyond the maximum length cause a panic, as with descriptors.

Parameters

IMPORT_C void Close();

Description