Chapter 1

Class name Description
storage. The array is modifiable; for instance, you can append,
insert, and delete elements, but the elements are not modifiable.
Supports uniqueness, searching, and sorting. To search and sort,
you just need to specify the type of comparison to use.
CDesC8ArrayFlat As CDesCArrayFlat, but stores 8-bit descriptors.
CDesCArraySeg As CDesCArrayFlat, but implemented using a segmented buffer
for storage.
CDesC8ArraySeg As CDesCArraySeg, but stores 8-bit descriptors.
CPtrCArray A dynamic array of 16-bit pointer descriptors using a flat buffer for
storage. This is similar to CDesCArrayFlat but it stores an array
of TPtrC16s rather than the actual data, so it can be used in
preference to avoid duplicating memory. Searching and sorting is
done in a similar way to the CArrayFix classes, using a key
specification (with zero for the offset). Does not own the array
elements.
CPtrC8Array As CPtrCArray, but stores 8-bit pointer descriptors.
Notes:
� Descriptor arrays can be used to hold any type of descriptor. They can be used in APIs
that require an MDesCArray, for instance, text list boxes.
� CDesCArray classes make a copy of each element added to the array, so afterwards
the original descriptor can safely be deleted.
� CPtrCArray classes hold pointers to the descriptors, rather than the descriptors
themselves, so they use less memory than CDesCArray classes, but care must be
taken since they can hold invalid data if the descriptor pointed to is deleted.
� The build-independent descriptor arrays (CDesCArrayFlat, CDes-CArraySeg and
CPtrCArray) are defined as the 16-bit variants, so, when storing binary data rather
than text, you need to explicitly specify the 8-bit variant.
8.1.4 Locale
e32std.h includes many locale-related classes, covering time zones, formatting for time,
date, and currency, measurement units for short distances (inches vs. cm) and long
distances (miles vs. km). In a complete Symbian OS platform, these values are usually set
through the control panel and are used to prepare times, dates, currency values, and so on
for display.
Locale settings depend on:
� The ROM locale: for instance, a German machine will include German resource files,
aif files and spell check dictionaries.
� The home city : controls the current time zone, and in UIQ can be set through the
control panel or the Time application. The home city default is ROM-locale dependent.
� Miscellaneous settings: other locale settings are entered by the user through the
control panel, with ROM-locale dependent defaults.
Language downgrade path