The -array buffer

diff -r 4816d766a08a -r f345bda72bc4 Symbian3/PDK/Source/GUID-9452D60C-CD3E-570D-885F-F329264AB6F4.dita --- a/Symbian3/PDK/Source/GUID-9452D60C-CD3E-570D-885F-F329264AB6F4.dita Tue Mar 30 11:42:04 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-9452D60C-CD3E-570D-885F-F329264AB6F4.dita Tue Mar 30 11:56:28 2010 +0100 @@ -1,41 +1,41 @@ - - - - - -The -array bufferDescribes the array buffer. -

All arrays have an array buffer. The implementation of this buffer and -the way it is used depend on the specific type of array.

In fixed length arrays and packed arrays the elements are contained within -the array buffer itself.

In variable length arrays each element is contained within its own heap -cell and the array buffer contains pointers to the elements.

Logically, an array buffer is linear but, physically, it can be organised -either as a flat buffer or a segmented buffer.

In general, you can choose between array classes which use a flat array -buffer and array classes which use a segmented array buffer. The choice depends -on how the array is to be used.

A segmented array buffer is implemented using a CBufSeg object.

A flat array buffer is implemented either:

directly by the array -as a piece of linear memory.

using a CBufFlat object.

The first has a simple and efficient implementation but has some restrictions -on the size of an array element and is limited to holding fixed length elements. -The second is a more general implementation but is only limited by the memory -available.