Chapter 1

File Name Purpose
s32stor.h CStreamStore Base class, with extend, delete, commit,
revert, reclaim, and compact functions – not
all of which are available in all
implementations.
s32stor.h CPersistentStore Adds a root stream to CstreamStore.
s32file.h CEmbeddedStore An embedded store: opens a new one on a
write stream or an old one on a read stream.
s32stor.h CFileStore File-based persistent store. Constructors
specify either an RFs and a filename or an
already open RFile.
s32file.h CDirectFileStore Direct file store. Has a wide variety of
constructors supporting all file-related open
functions(open, create, replace, and temp).
Can also be constructed from an already
open RFile.
s32file.h CPermanentFileStore Permanent file store. Has a wide variety of
constructors.
s32mem.h CBufStore Nonpersistent store in a privately owned
CbufBase.
s32crypt.h CSecureStore Secure store with encrypted streams and
the like. Constructors specify host stream
store, CSecurityBase encryption
algorithm, and an initialization string.
Beware of the following sources of potential confusion:
� Don't get confused between a persistent store and a permanent file store. A
persistent store has a root stream and can persist after you've closed it. A permanent
file store is the type of file store that's used by database applications; the database itself
is permanent, although its entries may be saved, deleted, or replaced.
� Don't use file write streams and file read streams to access file stores; you use them to
access files when the file is not a file store. All store types should be accessed with
store write streams and store read streams – most often, you only need to use the write
stream and read stream interfaces.
13.8 Dictionary Stores and .ini Files
A persistent stream store includes a stream network in which streams may contain stream
IDs that refer to other streams and which has a single root stream.
In contrast, a dictionary store contains a list of streams, each of which is accessed using a
UID, rather than a stream ID: