LString is a convenient, general-purpose string class derived from RBuf . LString adds automatic cleanup and on-demand buffer resize facilities. Like an RBuf , an LString can be passed to any function that is prototyped to take a TDes or a TDesC reference. Again like an RBuf , an LString maintains its string data in a heap buffer.
While being simpler to use than existing descriptors in many cases, LString's use of heap allocation and it’s resizing variant methods clearly come with associated costs. Their use in performance-critical code should be carefully considered. On the other hand, LString's small stack footprint and ability to better-handle inputs of unpredictable size may make them a better choice when the alternative is a large, fixed-max-size TBuf or HBufC .
LString is part of the EUser High Level library which is found in euserhl.dll . To use LString you must link euserhl.lib library and include estring.h header file.
The following are the characteristics of LString:
Automatic in-place resizing: LString replaces standard descriptor APIs with a corresponding leaving method that automatically expands the underlying buffer on-demand.
Automatic Growth: LString supports automatic growth when being manipulated directly as an LString. When an LString is passed to a function accepting a TDes() that function will operate on it as if it is a fixed-max-length descriptor.
Compression: It is difficult to predict the use of an LString object and therefore auto-compression would likely result in further allocations and be inefficient. If compression is desired this must be done manually via LString::Compress() .
The following are the LString APIs:
Description: This method sets the storage space allocated to this descriptor to the specified value by growing or compressing its buffer size. If the current length of the descriptor is greater than the specified max length, length is truncated to max length.
Description: This method ensures that the remaining unused space is more than the supplied value. It may reallocate a larger storage space to meet the requirement. As a result MaxLength() and Ptr() may return different values afterwards, and any existing raw pointers to into the descriptor data may be invalidated.
Description: This method re-allocates a smaller descriptor buffer space to the current descriptor length. This may cause the string descriptor's heap buffer to be reallocated in order to accommodate the new data. As a result, MaxLength() and Ptr() may return different values afterwards, and any existing raw pointers to into the descriptor data may be invalidated.
Description: This method re-initialises the descriptor destroying its payload.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.