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-77ECD89F-84BB-55F1-9876-382E043F0C0D" xml:lang="en"><title>XML

    13 Error Handling Reference</title><shortdesc>This section describes how the different components dealing with

    14 XML manage error conditions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>In all cases, ensure that your XML is valid and well-formed when using

    16 one of the parsers below. </p>

    17 <p> <b>libxml2 component</b>  </p>

    18 <p>The libxml2 C library has its own error codes and returns <codeph>NULL</codeph> pointers

    19 in Out-Of-Memory conditions. It also stores the last parsing error in a member

    20 of the global <codeph>_xmlGlobalState</codeph> structure. Access this variable

    21 using TLS (Thread-Local Storage). </p>

    22 <p>The methods of the Utilities wrapper leave when they detect an Out-Of-Memory

    23 condition in the libxml2 library. </p>

    24 <p> <b>XML DOM Engine</b>  </p>

    25 <p>When calling a method of the XML DOM Engine, check its return value for

    26 an error code. </p>

    27 <p>Methods that leave do so in Out-Of-Memory conditions. Methods that read

    28 or write files also leave on I/O errors. </p>

    29 <p> <b>XML DOM Engine Serialiser</b>  </p>

    30 <p>The serialiser does not forward all the libxml2 errors and may leave with

    31 the Symbian platform mechanism instead. </p>

    32 <p> <b>XML Framework</b>  </p>

    33 <p>The libxml2 SAX plugin maps the errors received from the libxml2 parser

    34 to parsing events. The leave mechanism only applies when the error is fatal

    35 for the libxml2 parser. </p>

    36 <p>The Expat and WBXML parser plugins use a combination of parsing events

    37 and leaves to handle errors. </p>

    38 </conbody><related-links>

    39 <link href="GUID-33D50AB9-AFA8-521F-8A85-031C24EA7D25.dita"><linktext>libxml2</linktext>

    40 </link>

    41 <link href="GUID-5ACFA8E4-3C4B-5851-A43E-9FA72D0B8403.dita"><linktext>XML DOM Engine</linktext>

    42 </link>

    43 <link href="GUID-F79E4F18-19E2-577E-8409-8B82BD48AC66.dita"><linktext>XML Framework</linktext>

    44 </link>

    45 </related-links></concept>