--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-C5C30218-311C-58D9-A990-3F95642F7517.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE task
+  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
+<task id="GUID-C5C30218-311C-58D9-A990-3F95642F7517" xml:lang="en"><title>Parsing
+XML DOM</title><shortdesc>This topic explains how to build a DOM tree by parsing an XML file. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<prereq><p>Before you start, you must: </p> <ul>
+<li id="GUID-B39FCCC0-8791-5234-977A-868616FF4A46"><p>understand the concept
+of <xref href="http://www.w3.org/DOM/" scope="external">Document Object Model
+(DOM)</xref>  </p> </li>
+<li id="GUID-5FEE15C3-9808-5B50-B19B-52C62CC10E46"><p>understand the architecture
+and classes of the <xref href="GUID-5ACFA8E4-3C4B-5851-A43E-9FA72D0B8403.dita">XML
+DOM Engine</xref> component </p> </li>
+<li id="GUID-462DFB7D-1E1D-54C1-A63B-8CE73A8775B5"><p>prepare an XML file
+containing valid XML data </p> </li>
+</ul> </prereq>
+<steps id="GUID-3D797BCC-4D06-5275-9B4F-CAB51649E6D1">
+<step id="GUID-3DF73431-C215-59FD-9AE7-B4C8FDB98A1C"><cmd/>
+<info>Call the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>XmlEnginePushL()</apiname></xref> method to
+put parser resources on the clean-up stack. </info>
+<stepxmp><codeblock id="GUID-975C0070-DD3D-58CE-908F-687659F45F76" xml:space="preserve">
+XmlEnginePushL();
+</codeblock> </stepxmp>
+</step>
+<step id="GUID-63B2D6CC-5B11-5466-BD05-837F18D0A810"><cmd>Initialise your
+instance of the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>RXmlEngDOMImplementation</apiname></xref> class
+by calling its <codeph>OpenL()</codeph> method. </cmd>
+<stepxmp><codeblock id="GUID-F750DC25-5702-5424-AF2F-5C5D229AB296" xml:space="preserve">
+RXMlEngDOMImplementation impl;
+impl.OpenL();
+</codeblock> </stepxmp>
+<info>The <codeph>RXMlEngDOMImplementation</codeph> instance is the DOM Engine. </info>
+</step>
+<step id="GUID-5C57654A-7B78-5E5D-90E1-94CA025B024B"><cmd/>
+<info>Initialise the DOM parser by calling the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>RXmlEngDOMParser::Open()</apiname></xref> method
+on its instance. </info>
+<stepxmp><codeblock id="GUID-F29FAB78-BAE3-553C-858A-6E80A76F754D" xml:space="preserve">
+RXmlEngDOMParser parser;
+parser.Open( impl );
+</codeblock> </stepxmp>
+<info>You can also have several parsers registered on a DOM Engine instance. </info>
+</step>
+<step id="GUID-70BA1E03-92D4-5A3A-9079-A00236D30923"><cmd/>
+<info>Parse the specified XML file by calling the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>RXmlEngDOMParser::ParseFileL()</apiname></xref> method. </info>
+<stepxmp><codeblock id="GUID-3E26315C-F901-5350-9936-11A6045E7FE7" xml:space="preserve">
+RXmlDocument myDoc = parser.ParseFileL( "tutorial.xml" );
+</codeblock> </stepxmp>
+<info>The <codeph>myDoc</codeph> object is a DOM tree containing the data
+from the XML file. </info>
+</step>
+<step id="GUID-97FC75A5-A4EA-55DC-841B-745E391E2C90"><cmd/>
+<info>Use the created DOM tree. </info>
+<info>For example, refer to the <xref href="GUID-92C2317A-57B8-558E-984B-B10FD0404981.dita">Searching
+a DOM Tree using XPath</xref> to search for specific elements or attributes
+in the DOM tree. </info>
+</step>
+<step id="GUID-9935393A-1359-5708-A9F3-B779F2E2B418"><cmd/>
+<info>Free your resources as necessary. </info>
+<substeps id="GUID-CB3D86A2-561D-5281-9DA4-AA8C70A0F498">
+<substep id="GUID-6D1DC97D-5068-5FCD-AD69-510778348899"><cmd>Close the parser
+and the engine by calling their <codeph>Close()</codeph> functions. </cmd>
+<stepxmp><codeblock id="GUID-53680EE0-8291-5C9A-9A7A-04437B1A0836" xml:space="preserve">
+parser.Close();
+impl.Close();
+</codeblock> </stepxmp>
+</substep>
+<substep id="GUID-1C28D8BE-D03B-5D9B-BCC7-355FB2A6A93C"><cmd/>
+<info>Close the XML library by calling the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>XmlPopAndClose()</apiname></xref> method.
+This method also removes the serialisation resources from the clean-up stack. </info>
+</substep>
+<substep id="GUID-BCD8662A-7C1E-5239-87C9-E3917D79C326"><cmd/>
+<info>Perform any other clean-up operations. </info>
+</substep>
+</substeps>
+</step>
+</steps>
+</taskbody><related-links>
+<link href="GUID-92C2317A-57B8-558E-984B-B10FD0404981.dita"><linktext>Searching
+a DOM Tree using XPath</linktext></link>
+<link href="GUID-E20C2C98-A294-551B-99CF-BE1DAA6F597E.dita"><linktext>Serialising
+XML DOM</linktext></link>
+</related-links></task>
\ No newline at end of file