|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-50AB1B77-1912-5C73-A1B5-41220E7A2EA5" xml:lang="en"><title>Store |
|
13 map as repository for Swizzles and associated stream IDs</title><shortdesc>This document describes using a store map as a repository for Swizzles |
|
14 and associated stream IDs.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <p>A store map is a table of entries where each entry consists of a Swizzle |
|
16 and a stream ID.</p> |
|
17 <p>When the in-memory object represented by a Swizzle is externalised, the |
|
18 resulting stream ID and the associated Swizzle can be added to a store map. |
|
19 The effect is to create an entry in the store map table containing the stream |
|
20 ID and the associated Swizzle; the Swizzle is said to be bound to the stream |
|
21 ID. Creating this entry in the store map is done using <codeph>CStoreMap::BindL()</codeph>.</p> |
|
22 <p>For a container type class <codeph>CCompound</codeph>, the diagram below |
|
23 shows the result of:</p> |
|
24 <ul> |
|
25 <li id="GUID-B49D7824-7128-506F-B026-A6F4785C5C94"><p>streaming out the in-memory |
|
26 objects represented by the Swizzles <codeph>iA</codeph>, <codeph>iB</codeph> and <codeph>iC</codeph>.</p> </li> |
|
27 <li id="GUID-F3352249-7B90-5F90-B706-A01DC2C87C41"><p>binding the swizzles |
|
28 with the resulting stream IDs</p> </li> |
|
29 </ul> |
|
30 <p>The other characteristics of a store map follow from this. </p> |
|
31 <fig id="GUID-16CAA671-B195-558E-868A-46463EDEB476"> |
|
32 <title/> |
|
33 <image href="GUID-4028CDCF-D2E8-5668-A751-A7CFA86CED46_d0e363900_href.png" placement="inline"/> |
|
34 </fig> |
|
35 <p>Entries in the store map can be deleted. An entry can be identified either |
|
36 by Swizzle or by stream ID. <codeph>CStoreMap::Unbind()</codeph> deletes an |
|
37 entry identified by Swizzle; <codeph>CStoreMap::Forget()</codeph> deletes |
|
38 an entry identified by stream ID.</p> |
|
39 </conbody></concept> |