Collapse all Symbian^3 Product Developer Library

CEmbeddedStore Class Reference

class CEmbeddedStore : public CPersistentStore

Encapsulates an embedded store.

The embedded store may contain an arbitrarily complex network of streams, but is viewed as simply another stream by the embedding store. This means that the embedded store can dealt with as a single stream for purposes of copying or deleting.

Once streams within the embedded store have been committed and closed, they cannot subsequently be changed, i.e. streams cannot be replaced, deleted, extended or changed in any way.

CPersistentStore

Inherits from

CEmbeddedStore
- CPersistentStore
  - CStreamStore
    - CBase

Public Member Functions
	CEmbeddedStore(MStreamBuf *)
	~CEmbeddedStore()
IMPORT_C void	ConstructL(RWriteStream &)
IMPORT_C void	Detach()
IMPORT_C CEmbeddedStore *	FromL(RReadStream &)
IMPORT_C CEmbeddedStore *	FromLC(RReadStream &)
MStreamBuf *	Host()
IMPORT_C void	MarshalL(RReadStream &)
IMPORT_C CEmbeddedStore *	NewL(RWriteStream &)
IMPORT_C CEmbeddedStore *	NewLC(RWriteStream &)
TStreamPos	Position(TStreamId)
void	Reattach(MStreamBuf *)
TStreamPos	Start()

Protected Member Functions
IMPORT_C MStreamBuf *	DoCreateL(TStreamId &)
IMPORT_C MStreamBuf *	DoReadL(TStreamId)

Private Member Functions
IMPORT_C void	DoCommitL()
CEmbeddedStore *	DoNewLC(MStreamBuf *)
IMPORT_C void	DoSetRootL(TStreamId)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CPersistentStore::CPersistentStore()
	CPersistentStore::Root()const
	CPersistentStore::SetRootL(TStreamId)
	CStreamStore::Commit()
	CStreamStore::CommitL()
	CStreamStore::CompactL()
	CStreamStore::Delete(TStreamId)
	CStreamStore::DeleteL(TStreamId)
	CStreamStore::ExtendL()
	CStreamStore::ReclaimL()
	CStreamStore::Revert()
	CStreamStore::RevertL()

Private Attributes
__MUTABLE TStreamExchange	iHost
TStreamPos	iStart

Inherited Attributes
	CPersistentStore::iRoot

Constructor & Destructor Documentation

CEmbeddedStore(MStreamBuf *)

IMPORT_C

CEmbeddedStore

(

MStreamBuf *

aHost

)

Parameters

MStreamBuf * aHost

~CEmbeddedStore()

IMPORT_C

~CEmbeddedStore

(

)

Member Functions Documentation

ConstructL(RWriteStream &)

IMPORT_C void

ConstructL

(

RWriteStream &

aStream

)

Parameters

RWriteStream & aStream

Detach()

IMPORT_C void

Detach

(

)

DoCommitL()

IMPORT_C void

DoCommitL

(

)

[private, virtual]

DoCreateL(TStreamId &)

IMPORT_C MStreamBuf *

DoCreateL

(

TStreamId &

anId

)

[protected, virtual]

Creates a new stream in the store. The function gets the allocated stream id in the anId parameter. A stream buffer for the stream should be returned, ready to write into the new stream. This provides the implementation for the RStoreWriteStream::CreateL() functions.

Parameters

TStreamId & anId

On return, contains the allocated stream id.

DoNewLC(MStreamBuf *)

CEmbeddedStore *

DoNewLC

(

MStreamBuf *

aHost

)

[private, static]

Parameters

MStreamBuf * aHost

DoReadL(TStreamId)

IMPORT_C MStreamBuf *

DoReadL

(

TStreamId

anId

)

const [protected, virtual]

Opens the requested stream for reading. The function should return a stream buffer positioned at the beginning of this stream.

This function is called by the OpenL() and OpenLC() member functions of RStoreReadStream.

RStoreReadStream::OpenL() RStoreReadStream::OpenLC()

Parameters

TStreamId anId

The stream to be read.

DoSetRootL(TStreamId)

IMPORT_C void

DoSetRootL

(

TStreamId

anId

)

[private, virtual]

Parameters

TStreamId anId

FromL(RReadStream &)

IMPORT_C CEmbeddedStore *

FromL

(

RReadStream &

aHost

)

[static]

Parameters

RReadStream & aHost

FromLC(RReadStream &)

IMPORT_C CEmbeddedStore *

FromLC

(

RReadStream &

aHost

)

[static]

Parameters

RReadStream & aHost

Host()

MStreamBuf *

Host

(

)

const [inline]

Returns a pointer to the stream buffer which is acting as host to this embedded store. The embedded store retains ownership of the host stream buffer.