FCL/sf/adapt/qemu: symbian-qemu-0.9.1-12/expat-2.0.0/doc/reference.html@10852f1a0ae9 (annotated)

1 2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1	<?xml version="1.0" encoding="iso-8859-1"?>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	3	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	4	<html>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	5	<head>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	6	<!-- Copyright 1999,2000 Clark Cooper <coopercc@netheaven.com>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	7	All rights reserved.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	8	This is free software. You may distribute or modify according to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	9	the terms of the MIT/X License -->
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	10	<title>Expat XML Parser</title>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	11	<meta name="author" content="Clark Cooper, coopercc@netheaven.com" />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	12	<meta http-equiv="Content-Style-Type" content="text/css" />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	13	<link href="style.css" rel="stylesheet" type="text/css" />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	14	</head>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	15	<body>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	16	<table cellspacing="0" cellpadding="0" width="100%">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	17	<tr>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	18	<td class="corner"><img src="expat.png" alt="(Expat logo)" /></td>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	19	<td class="banner"><h1>The Expat XML Parser</h1></td>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	20	</tr>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	21	<tr>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	22	<td class="releaseno">Release 2.0.0</td>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	23	<td></td>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	24	</tr>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	25	</table>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	26	<div class="content">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	27
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	28	<p>Expat is a library, written in C, for parsing XML documents. It's
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	29	the underlying XML parser for the open source Mozilla project, Perl's
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	30	<code>XML::Parser</code>, Python's <code>xml.parsers.expat</code>, and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	31	other open-source XML parsers.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	32
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	33	<p>This library is the creation of James Clark, who's also given us
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	34	groff (an nroff look-alike), Jade (an implemention of ISO's DSSSL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	35	stylesheet language for SGML), XP (a Java XML parser package), XT (a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	36	Java XSL engine). James was also the technical lead on the XML
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	37	Working Group at W3C that produced the XML specification.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	38
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	39	<p>This is free software, licensed under the <a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	40	href="../COPYING">MIT/X Consortium license</a>. You may download it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	41	from <a href="http://www.libexpat.org/">the Expat home page</a>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	42	</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	43
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	44	<p>The bulk of this document was originally commissioned as an article
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	45	by <a href="http://www.xml.com/">XML.com</a>. They graciously allowed
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	46	Clark Cooper to retain copyright and to distribute it with Expat.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	47	This version has been substantially extended to include documentation
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	48	on features which have been added since the original article was
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	49	published, and additional information on using the original
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	50	interface.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	51
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	52	<hr />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	53	<h2>Table of Contents</h2>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	54	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	55	<li><a href="#overview">Overview</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	56	<li><a href="#building">Building and Installing</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	57	<li><a href="#using">Using Expat</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	58	<li><a href="#reference">Reference</a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	59	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	60	<li><a href="#creation">Parser Creation Functions</a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	61	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	62	<li><a href="#XML_ParserCreate">XML_ParserCreate</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	63	<li><a href="#XML_ParserCreateNS">XML_ParserCreateNS</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	64	<li><a href="#XML_ParserCreate_MM">XML_ParserCreate_MM</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	65	<li><a href="#XML_ExternalEntityParserCreate">XML_ExternalEntityParserCreate</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	66	<li><a href="#XML_ParserFree">XML_ParserFree</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	67	<li><a href="#XML_ParserReset">XML_ParserReset</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	68	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	69	</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	70	<li><a href="#parsing">Parsing Functions</a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	71	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	72	<li><a href="#XML_Parse">XML_Parse</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	73	<li><a href="#XML_ParseBuffer">XML_ParseBuffer</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	74	<li><a href="#XML_GetBuffer">XML_GetBuffer</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	75	<li><a href="#XML_StopParser">XML_StopParser</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	76	<li><a href="#XML_ResumeParser">XML_ResumeParser</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	77	<li><a href="#XML_GetParsingStatus">XML_GetParsingStatus</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	78	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	79	</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	80	<li><a href="#setting">Handler Setting Functions</a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	81	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	82	<li><a href="#XML_SetStartElementHandler">XML_SetStartElementHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	83	<li><a href="#XML_SetEndElementHandler">XML_SetEndElementHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	84	<li><a href="#XML_SetElementHandler">XML_SetElementHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	85	<li><a href="#XML_SetCharacterDataHandler">XML_SetCharacterDataHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	86	<li><a href="#XML_SetProcessingInstructionHandler">XML_SetProcessingInstructionHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	87	<li><a href="#XML_SetCommentHandler">XML_SetCommentHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	88	<li><a href="#XML_SetStartCdataSectionHandler">XML_SetStartCdataSectionHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	89	<li><a href="#XML_SetEndCdataSectionHandler">XML_SetEndCdataSectionHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	90	<li><a href="#XML_SetCdataSectionHandler">XML_SetCdataSectionHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	91	<li><a href="#XML_SetDefaultHandler">XML_SetDefaultHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	92	<li><a href="#XML_SetDefaultHandlerExpand">XML_SetDefaultHandlerExpand</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	93	<li><a href="#XML_SetExternalEntityRefHandler">XML_SetExternalEntityRefHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	94	<li><a href="#XML_SetExternalEntityRefHandlerArg">XML_SetExternalEntityRefHandlerArg</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	95	<li><a href="#XML_SetSkippedEntityHandler">XML_SetSkippedEntityHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	96	<li><a href="#XML_SetUnknownEncodingHandler">XML_SetUnknownEncodingHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	97	<li><a href="#XML_SetStartNamespaceDeclHandler">XML_SetStartNamespaceDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	98	<li><a href="#XML_SetEndNamespaceDeclHandler">XML_SetEndNamespaceDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	99	<li><a href="#XML_SetNamespaceDeclHandler">XML_SetNamespaceDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	100	<li><a href="#XML_SetXmlDeclHandler">XML_SetXmlDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	101	<li><a href="#XML_SetStartDoctypeDeclHandler">XML_SetStartDoctypeDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	102	<li><a href="#XML_SetEndDoctypeDeclHandler">XML_SetEndDoctypeDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	103	<li><a href="#XML_SetDoctypeDeclHandler">XML_SetDoctypeDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	104	<li><a href="#XML_SetElementDeclHandler">XML_SetElementDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	105	<li><a href="#XML_SetAttlistDeclHandler">XML_SetAttlistDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	106	<li><a href="#XML_SetEntityDeclHandler">XML_SetEntityDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	107	<li><a href="#XML_SetUnparsedEntityDeclHandler">XML_SetUnparsedEntityDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	108	<li><a href="#XML_SetNotationDeclHandler">XML_SetNotationDeclHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	109	<li><a href="#XML_SetNotStandaloneHandler">XML_SetNotStandaloneHandler</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	110	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	111	</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	112	<li><a href="#position">Parse Position and Error Reporting Functions</a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	113	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	114	<li><a href="#XML_GetErrorCode">XML_GetErrorCode</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	115	<li><a href="#XML_ErrorString">XML_ErrorString</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	116	<li><a href="#XML_GetCurrentByteIndex">XML_GetCurrentByteIndex</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	117	<li><a href="#XML_GetCurrentLineNumber">XML_GetCurrentLineNumber</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	118	<li><a href="#XML_GetCurrentColumnNumber">XML_GetCurrentColumnNumber</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	119	<li><a href="#XML_GetCurrentByteCount">XML_GetCurrentByteCount</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	120	<li><a href="#XML_GetInputContext">XML_GetInputContext</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	121	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	122	</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	123	<li><a href="#miscellaneous">Miscellaneous Functions</a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	124	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	125	<li><a href="#XML_SetUserData">XML_SetUserData</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	126	<li><a href="#XML_GetUserData">XML_GetUserData</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	127	<li><a href="#XML_UseParserAsHandlerArg">XML_UseParserAsHandlerArg</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	128	<li><a href="#XML_SetBase">XML_SetBase</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	129	<li><a href="#XML_GetBase">XML_GetBase</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	130	<li><a href="#XML_GetSpecifiedAttributeCount">XML_GetSpecifiedAttributeCount</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	131	<li><a href="#XML_GetIdAttributeIndex">XML_GetIdAttributeIndex</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	132	<li><a href="#XML_SetEncoding">XML_SetEncoding</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	133	<li><a href="#XML_SetParamEntityParsing">XML_SetParamEntityParsing</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	134	<li><a href="#XML_UseForeignDTD">XML_UseForeignDTD</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	135	<li><a href="#XML_SetReturnNSTriplet">XML_SetReturnNSTriplet</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	136	<li><a href="#XML_DefaultCurrent">XML_DefaultCurrent</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	137	<li><a href="#XML_ExpatVersion">XML_ExpatVersion</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	138	<li><a href="#XML_ExpatVersionInfo">XML_ExpatVersionInfo</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	139	<li><a href="#XML_GetFeatureList">XML_GetFeatureList</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	140	<li><a href="#XML_FreeContentModel">XML_FreeContentModel</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	141	<li><a href="#XML_MemMalloc">XML_MemMalloc</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	142	<li><a href="#XML_MemRealloc">XML_MemRealloc</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	143	<li><a href="#XML_MemFree">XML_MemFree</a></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	144	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	145	</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	146	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	147	</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	148	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	149
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	150	<hr />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	151	<h2><a name="overview">Overview</a></h2>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	152
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	153	<p>Expat is a stream-oriented parser. You register callback (or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	154	handler) functions with the parser and then start feeding it the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	155	document. As the parser recognizes parts of the document, it will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	156	call the appropriate handler for that part (if you've registered one.)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	157	The document is fed to the parser in pieces, so you can start parsing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	158	before you have all the document. This also allows you to parse really
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	159	huge documents that won't fit into memory.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	160
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	161	<p>Expat can be intimidating due to the many kinds of handlers and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	162	options you can set. But you only need to learn four functions in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	163	order to do 90% of what you'll want to do with it:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	164
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	165	<dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	166
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	167	<dt><code><a href= "#XML_ParserCreate"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	168	>XML_ParserCreate</a></code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	169	<dd>Create a new parser object.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	170
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	171	<dt><code><a href= "#XML_SetElementHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	172	>XML_SetElementHandler</a></code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	173	<dd>Set handlers for start and end tags.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	174
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	175	<dt><code><a href= "#XML_SetCharacterDataHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	176	>XML_SetCharacterDataHandler</a></code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	177	<dd>Set handler for text.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	178
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	179	<dt><code><a href= "#XML_Parse"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	180	>XML_Parse</a></code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	181	<dd>Pass a buffer full of document to the parser</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	182	</dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	183
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	184	<p>These functions and others are described in the <a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	185	href="#reference">reference</a> part of this document. The reference
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	186	section also describes in detail the parameters passed to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	187	different types of handlers.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	188
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	189	<p>Let's look at a very simple example program that only uses 3 of the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	190	above functions (it doesn't need to set a character handler.) The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	191	program <a href="../examples/outline.c">outline.c</a> prints an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	192	element outline, indenting child elements to distinguish them from the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	193	parent element that contains them. The start handler does all the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	194	work. It prints two indenting spaces for every level of ancestor
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	195	elements, then it prints the element and attribute
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	196	information. Finally it increments the global <code>Depth</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	197	variable.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	198
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	199	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	200	int Depth;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	201
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	202	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	203	start(void data, const char el, const char **attr) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	204	int i;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	205
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	206	for (i = 0; i < Depth; i++)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	207	printf(" ");
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	208
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	209	printf("%s", el);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	210
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	211	for (i = 0; attr[i]; i += 2) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	212	printf(" %s='%s'", attr[i], attr[i + 1]);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	213	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	214
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	215	printf("\n");
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	216	Depth++;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	217	} /* End of start handler */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	218	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	219
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	220	<p>The end tag simply does the bookkeeping work of decrementing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	221	<code>Depth</code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	222	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	223	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	224	end(void data, const char el) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	225	Depth--;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	226	} /* End of end handler */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	227	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	228
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	229	<p>Note the <code>XMLCALL</code> annotation used for the callbacks.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	230	This is used to ensure that the Expat and the callbacks are using the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	231	same calling convention in case the compiler options used for Expat
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	232	itself and the client code are different. Expat tries not to care
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	233	what the default calling convention is, though it may require that it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	234	be compiled with a default convention of "cdecl" on some platforms.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	235	For code which uses Expat, however, the calling convention is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	236	specified by the <code>XMLCALL</code> annotation on most platforms;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	237	callbacks should be defined using this annotation.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	238
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	239	<p>The <code>XMLCALL</code> annotation was added in Expat 1.95.7, but
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	240	existing working Expat applications don't need to add it (since they
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	241	are already using the "cdecl" calling convention, or they wouldn't be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	242	working). The annotation is only needed if the default calling
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	243	convention may be something other than "cdecl". To use the annotation
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	244	safely with older versions of Expat, you can conditionally define it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	245	<em>after</em> including Expat's header file:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	246
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	247	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	248	#include <expat.h>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	249
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	250	#ifndef XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	251	#if defined(_MSC_EXTENSIONS) && !defined(__BEOS__) && !defined(__CYGWIN__)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	252	#define XMLCALL __cdecl
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	253	#elif defined(__GNUC__)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	254	#define XMLCALL __attribute__((cdecl))
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	255	#else
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	256	#define XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	257	#endif
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	258	#endif
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	259	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	260
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	261	<p>After creating the parser, the main program just has the job of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	262	shoveling the document to the parser so that it can do its work.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	263
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	264	<hr />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	265	<h2><a name="building">Building and Installing Expat</a></h2>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	266
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	267	<p>The Expat distribution comes as a compressed (with GNU gzip) tar
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	268	file. You may download the latest version from <a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	269	"http://sourceforge.net/projects/expat/" >Source Forge</a>. After
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	270	unpacking this, cd into the directory. Then follow either the Win32
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	271	directions or Unix directions below.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	272
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	273	<h3>Building under Win32</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	274
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	275	<p>If you're using the GNU compiler under cygwin, follow the Unix
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	276	directions in the next section. Otherwise if you have Microsoft's
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	277	Developer Studio installed, then from Windows Explorer double-click on
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	278	"expat.dsp" in the lib directory and build and install in the usual
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	279	manner.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	280
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	281	<p>Alternatively, you may download the Win32 binary package that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	282	contains the "expat.h" include file and a pre-built DLL.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	283
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	284	<h3>Building under Unix (or GNU)</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	285
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	286	<p>First you'll need to run the configure shell script in order to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	287	configure the Makefiles and headers for your system.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	288
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	289	<p>If you're happy with all the defaults that configure picks for you,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	290	and you have permission on your system to install into /usr/local, you
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	291	can install Expat with this sequence of commands:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	292
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	293	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	294	./configure
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	295	make
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	296	make install
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	297	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	298
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	299	<p>There are some options that you can provide to this script, but the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	300	only one we'll mention here is the <code>--prefix</code> option. You
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	301	can find out all the options available by running configure with just
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	302	the <code>--help</code> option.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	303
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	304	<p>By default, the configure script sets things up so that the library
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	305	gets installed in <code>/usr/local/lib</code> and the associated
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	306	header file in <code>/usr/local/include</code>. But if you were to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	307	give the option, <code>--prefix=/home/me/mystuff</code>, then the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	308	library and header would get installed in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	309	<code>/home/me/mystuff/lib</code> and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	310	<code>/home/me/mystuff/include</code> respectively.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	311
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	312	<h3>Configuring Expat Using the Pre-Processor</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	313
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	314	<p>Expat's feature set can be configured using a small number of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	315	pre-processor definitions. The definition of this symbols does not
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	316	affect the set of entry points for Expat, only the behavior of the API
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	317	and the definition of character types in the case of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	318	<code>XML_UNICODE_WCHAR_T</code>. The symbols are:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	319
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	320	<dl class="cpp-symbols">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	321	<dt>XML_DTD</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	322	<dd>Include support for using and reporting DTD-based content. If
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	323	this is defined, default attribute values from an external DTD subset
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	324	are reported and attribute value normalization occurs based on the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	325	type of attributes defined in the external subset. Without
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	326	this, Expat has a smaller memory footprint and can be faster, but will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	327	not load external entities or process conditional sections. This does
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	328	not affect the set of functions available in the API.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	329
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	330	<dt>XML_NS</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	331	<dd>When defined, support for the <cite><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	332	"http://www.w3.org/TR/REC-xml-names/" >Namespaces in XML</a></cite>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	333	specification is included.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	334
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	335	<dt>XML_UNICODE</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	336	<dd>When defined, character data reported to the application is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	337	encoded in UTF-16 using wide characters of the type
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	338	<code>XML_Char</code>. This is implied if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	339	<code>XML_UNICODE_WCHAR_T</code> is defined.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	340
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	341	<dt>XML_UNICODE_WCHAR_T</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	342	<dd>If defined, causes the <code>XML_Char</code> character type to be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	343	defined using the <code>wchar_t</code> type; otherwise, <code>unsigned
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	344	short</code> is used. Defining this implies
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	345	<code>XML_UNICODE</code>.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	346
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	347	<dt>XML_LARGE_SIZE</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	348	<dd>If defined, causes the <code>XML_Size</code> and <code>XML_Index</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	349	integer types to be at least 64 bits in size. This is intended to support
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	350	processing of very large input streams, where the return values of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	351	<code><a href="#XML_GetCurrentByteIndex" >XML_GetCurrentByteIndex</a></code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	352	<code><a href="#XML_GetCurrentLineNumber" >XML_GetCurrentLineNumber</a></code> and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	353	<code><a href="#XML_GetCurrentColumnNumber" >XML_GetCurrentColumnNumber</a></code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	354	could overflow. It may not be supported by all compilers, and is turned
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	355	off by default.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	356
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	357	<dt>XML_CONTEXT_BYTES</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	358	<dd>The number of input bytes of markup context which the parser will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	359	ensure are available for reporting via <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	360	"#XML_GetInputContext" >XML_GetInputContext</a></code>. This is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	361	normally set to 1024, and must be set to a positive interger. If this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	362	is not defined, the input context will not be available and <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	363	href= "#XML_GetInputContext" >XML_GetInputContext</a></code> will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	364	always report NULL. Without this, Expat has a smaller memory
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	365	footprint and can be faster.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	366
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	367	<dt>XML_STATIC</dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	368	<dd>On Windows, this should be set if Expat is going to be linked
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	369	statically with the code that calls it; this is required to get all
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	370	the right MSVC magic annotations correct. This is ignored on other
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	371	platforms.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	372	</dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	373
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	374	<hr />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	375	<h2><a name="using">Using Expat</a></h2>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	376
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	377	<h3>Compiling and Linking Against Expat</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	378
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	379	<p>Unless you installed Expat in a location not expected by your
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	380	compiler and linker, all you have to do to use Expat in your programs
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	381	is to include the Expat header (<code>#include <expat.h></code>)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	382	in your files that make calls to it and to tell the linker that it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	383	needs to link against the Expat library. On Unix systems, this would
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	384	usually be done with the <code>-lexpat</code> argument. Otherwise,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	385	you'll need to tell the compiler where to look for the Expat header
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	386	and the linker where to find the Expat library. You may also need to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	387	take steps to tell the operating system where to find this libary at
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	388	run time.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	389
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	390	<p>On a Unix-based system, here's what a Makefile might look like when
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	391	Expat is installed in a standard location:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	392
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	393	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	394	CC=cc
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	395	LDFLAGS=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	396	LIBS= -lexpat
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	397	xmlapp: xmlapp.o
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	398	$(CC) $(LDFLAGS) -o xmlapp xmlapp.o $(LIBS)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	399	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	400
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	401	<p>If you installed Expat in, say, <code>/home/me/mystuff</code>, then
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	402	the Makefile would look like this:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	403
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	404	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	405	CC=cc
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	406	CFLAGS= -I/home/me/mystuff/include
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	407	LDFLAGS=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	408	LIBS= -L/home/me/mystuff/lib -lexpat
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	409	xmlapp: xmlapp.o
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	410	$(CC) $(LDFLAGS) -o xmlapp xmlapp.o $(LIBS)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	411	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	412
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	413	<p>You'd also have to set the environment variable
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	414	<code>LD_LIBRARY_PATH</code> to <code>/home/me/mystuff/lib</code> (or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	415	to <code>${LD_LIBRARY_PATH}:/home/me/mystuff/lib</code> if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	416	LD_LIBRARY_PATH already has some directories in it) in order to run
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	417	your application.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	418
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	419	<h3>Expat Basics</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	420
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	421	<p>As we saw in the example in the overview, the first step in parsing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	422	an XML document with Expat is to create a parser object. There are <a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	423	href="#creation">three functions</a> in the Expat API for creating a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	424	parser object. However, only two of these (<code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	425	"#XML_ParserCreate" >XML_ParserCreate</a></code> and <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	426	"#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>) can be used for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	427	constructing a parser for a top-level document. The object returned
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	428	by these functions is an opaque pointer (i.e. "expat.h" declares it as
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	429	void *) to data with further internal structure. In order to free the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	430	memory associated with this object you must call <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	431	"#XML_ParserFree" >XML_ParserFree</a></code>. Note that if you have
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	432	provided any <a href="#userdata">user data</a> that gets stored in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	433	parser, then your application is responsible for freeing it prior to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	434	calling <code>XML_ParserFree</code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	435
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	436	<p>The objects returned by the parser creation functions are good for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	437	parsing only one XML document or external parsed entity. If your
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	438	application needs to parse many XML documents, then it needs to create
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	439	a parser object for each one. The best way to deal with this is to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	440	create a higher level object that contains all the default
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	441	initialization you want for your parser objects.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	442
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	443	<p>Walking through a document hierarchy with a stream oriented parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	444	will require a good stack mechanism in order to keep track of current
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	445	context. For instance, to answer the simple question, "What element
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	446	does this text belong to?" requires a stack, since the parser may have
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	447	descended into other elements that are children of the current one and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	448	has encountered this text on the way out.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	449
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	450	<p>The things you're likely to want to keep on a stack are the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	451	currently opened element and it's attributes. You push this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	452	information onto the stack in the start handler and you pop it off in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	453	the end handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	454
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	455	<p>For some tasks, it is sufficient to just keep information on what
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	456	the depth of the stack is (or would be if you had one.) The outline
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	457	program shown above presents one example. Another such task would be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	458	skipping over a complete element. When you see the start tag for the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	459	element you want to skip, you set a skip flag and record the depth at
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	460	which the element started. When the end tag handler encounters the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	461	same depth, the skipped element has ended and the flag may be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	462	cleared. If you follow the convention that the root element starts at
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	463	1, then you can use the same variable for skip flag and skip
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	464	depth.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	465
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	466	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	467	void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	468	init_info(Parseinfo *info) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	469	info->skip = 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	470	info->depth = 1;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	471	/* Other initializations here */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	472	} /* End of init_info */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	473
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	474	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	475	rawstart(void data, const char el, const char **attr) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	476	Parseinfo inf = (Parseinfo ) data;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	477
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	478	if (! inf->skip) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	479	if (should_skip(inf, el, attr)) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	480	inf->skip = inf->depth;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	481	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	482	else
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	483	start(inf, el, attr); /* This does rest of start handling */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	484	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	485
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	486	inf->depth++;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	487	} /* End of rawstart */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	488
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	489	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	490	rawend(void data, const char el) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	491	Parseinfo inf = (Parseinfo ) data;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	492
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	493	inf->depth--;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	494
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	495	if (! inf->skip)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	496	end(inf, el); /* This does rest of end handling */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	497
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	498	if (inf->skip == inf->depth)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	499	inf->skip = 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	500	} /* End rawend */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	501	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	502
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	503	<p>Notice in the above example the difference in how depth is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	504	manipulated in the start and end handlers. The end tag handler should
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	505	be the mirror image of the start tag handler. This is necessary to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	506	properly model containment. Since, in the start tag handler, we
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	507	incremented depth <em>after</em> the main body of start tag code, then
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	508	in the end handler, we need to manipulate it <em>before</em> the main
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	509	body. If we'd decided to increment it first thing in the start
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	510	handler, then we'd have had to decrement it last thing in the end
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	511	handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	512
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	513	<h3 id="userdata">Communicating between handlers</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	514
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	515	<p>In order to be able to pass information between different handlers
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	516	without using globals, you'll need to define a data structure to hold
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	517	the shared variables. You can then tell Expat (with the <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	518	"#XML_SetUserData" >XML_SetUserData</a></code> function) to pass a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	519	pointer to this structure to the handlers. This is the first
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	520	argument received by most handlers. In the <a href="#reference"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	521	>reference section</a>, an argument to a callback function is named
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	522	<code>userData</code> and have type <code>void *</code> if the user
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	523	data is passed; it will have the type <code>XML_Parser</code> if the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	524	parser itself is passed. When the parser is passed, the user data may
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	525	be retrieved using <code><a href="#XML_GetUserData"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	526	>XML_GetUserData</a></code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	527
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	528	<p>One common case where multiple calls to a single handler may need
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	529	to communicate using an application data structure is the case when
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	530	content passed to the character data handler (set by <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	531	"#XML_SetCharacterDataHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	532	>XML_SetCharacterDataHandler</a></code>) needs to be accumulated. A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	533	common first-time mistake with any of the event-oriented interfaces to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	534	an XML parser is to expect all the text contained in an element to be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	535	reported by a single call to the character data handler. Expat, like
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	536	many other XML parsers, reports such data as a sequence of calls;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	537	there's no way to know when the end of the sequence is reached until a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	538	different callback is made. A buffer referenced by the user data
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	539	structure proves both an effective and convenient place to accumulate
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	540	character data.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	541
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	542	<!-- XXX example needed here -->
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	543
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	544
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	545	<h3>XML Version</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	546
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	547	<p>Expat is an XML 1.0 parser, and as such never complains based on
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	548	the value of the <code>version</code> pseudo-attribute in the XML
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	549	declaration, if present.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	550
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	551	<p>If an application needs to check the version number (to support
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	552	alternate processing), it should use the <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	553	"#XML_SetXmlDeclHandler" >XML_SetXmlDeclHandler</a></code> function to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	554	set a handler that uses the information in the XML declaration to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	555	determine what to do. This example shows how to check that only a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	556	version number of <code>"1.0"</code> is accepted:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	557
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	558	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	559	static int wrong_version;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	560	static XML_Parser parser;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	561
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	562	static void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	563	xmldecl_handler(void *userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	564	const XML_Char *version,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	565	const XML_Char *encoding,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	566	int standalone)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	567	{
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	568	static const XML_Char Version_1_0[] = {'1', '.', '0', 0};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	569
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	570	int i;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	571
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	572	for (i = 0; i < (sizeof(Version_1_0) / sizeof(Version_1_0[0])); ++i) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	573	if (version[i] != Version_1_0[i]) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	574	wrong_version = 1;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	575	/* also clear all other handlers: */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	576	XML_SetCharacterDataHandler(parser, NULL);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	577	...
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	578	return;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	579	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	580	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	581	...
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	582	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	583	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	584
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	585	<h3>Namespace Processing</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	586
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	587	<p>When the parser is created using the <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	588	"#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>, function, Expat
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	589	performs namespace processing. Under namespace processing, Expat
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	590	consumes <code>xmlns</code> and <code>xmlns:...</code> attributes,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	591	which declare namespaces for the scope of the element in which they
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	592	occur. This means that your start handler will not see these
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	593	attributes. Your application can still be informed of these
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	594	declarations by setting namespace declaration handlers with <a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	595	"#XML_SetNamespaceDeclHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	596	><code>XML_SetNamespaceDeclHandler</code></a>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	597
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	598	<p>Element type and attribute names that belong to a given namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	599	are passed to the appropriate handler in expanded form. By default
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	600	this expanded form is a concatenation of the namespace URI, the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	601	separator character (which is the 2nd argument to <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	602	"#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>), and the local
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	603	name (i.e. the part after the colon). Names with undeclared prefixes
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	604	are not well-formed when namespace processing is enabled, and will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	605	trigger an error. Unprefixed attribute names are never expanded,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	606	and unprefixed element names are only expanded when they are in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	607	scope of a default namespace.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	608
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	609	<p>However if <code><a href= "#XML_SetReturnNSTriplet"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	610	>XML_SetReturnNSTriplet</a></code> has been called with a non-zero
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	611	<code>do_nst</code> parameter, then the expanded form for names with
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	612	an explicit prefix is a concatenation of: URI, separator, local name,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	613	separator, prefix.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	614
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	615	<p>You can set handlers for the start of a namespace declaration and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	616	for the end of a scope of a declaration with the <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	617	"#XML_SetNamespaceDeclHandler" >XML_SetNamespaceDeclHandler</a></code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	618	function. The StartNamespaceDeclHandler is called prior to the start
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	619	tag handler and the EndNamespaceDeclHandler is called after the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	620	corresponding end tag that ends the namespace's scope. The namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	621	start handler gets passed the prefix and URI for the namespace. For a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	622	default namespace declaration (xmlns='...'), the prefix will be null.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	623	The URI will be null for the case where the default namespace is being
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	624	unset. The namespace end handler just gets the prefix for the closing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	625	scope.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	626
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	627	<p>These handlers are called for each declaration. So if, for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	628	instance, a start tag had three namespace declarations, then the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	629	StartNamespaceDeclHandler would be called three times before the start
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	630	tag handler is called, once for each declaration.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	631
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	632	<h3>Character Encodings</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	633
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	634	<p>While XML is based on Unicode, and every XML processor is required
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	635	to recognized UTF-8 and UTF-16 (1 and 2 byte encodings of Unicode),
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	636	other encodings may be declared in XML documents or entities. For the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	637	main document, an XML declaration may contain an encoding
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	638	declaration:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	639	<pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	640	<?xml version="1.0" encoding="ISO-8859-2"?>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	641	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	642
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	643	<p>External parsed entities may begin with a text declaration, which
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	644	looks like an XML declaration with just an encoding declaration:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	645	<pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	646	<?xml encoding="Big5"?>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	647	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	648
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	649	<p>With Expat, you may also specify an encoding at the time of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	650	creating a parser. This is useful when the encoding information may
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	651	come from a source outside the document itself (like a higher level
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	652	protocol.)</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	653
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	654	<p><a name="builtin_encodings"></a>There are four built-in encodings
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	655	in Expat:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	656	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	657	<li>UTF-8</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	658	<li>UTF-16</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	659	<li>ISO-8859-1</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	660	<li>US-ASCII</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	661	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	662
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	663	<p>Anything else discovered in an encoding declaration or in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	664	protocol encoding specified in the parser constructor, triggers a call
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	665	to the <code>UnknownEncodingHandler</code>. This handler gets passed
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	666	the encoding name and a pointer to an <code>XML_Encoding</code> data
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	667	structure. Your handler must fill in this structure and return
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	668	<code>XML_STATUS_OK</code> if it knows how to deal with the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	669	encoding. Otherwise the handler should return
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	670	<code>XML_STATUS_ERROR</code>. The handler also gets passed a pointer
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	671	to an optional application data structure that you may indicate when
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	672	you set the handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	673
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	674	<p>Expat places restrictions on character encodings that it can
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	675	support by filling in the <code>XML_Encoding</code> structure.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	676	include file:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	677	<ol>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	678	<li>Every ASCII character that can appear in a well-formed XML document
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	679	must be represented by a single byte, and that byte must correspond to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	680	it's ASCII encoding (except for the characters $@\^'{}~)</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	681	<li>Characters must be encoded in 4 bytes or less.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	682	<li>All characters encoded must have Unicode scalar values less than or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	683	equal to 65535 (0xFFFF)<em>This does not apply to the built-in support
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	684	for UTF-16 and UTF-8</em></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	685	<li>No character may be encoded by more that one distinct sequence of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	686	bytes</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	687	</ol>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	688
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	689	<p><code>XML_Encoding</code> contains an array of integers that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	690	correspond to the 1st byte of an encoding sequence. If the value in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	691	the array for a byte is zero or positive, then the byte is a single
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	692	byte encoding that encodes the Unicode scalar value contained in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	693	array. A -1 in this array indicates a malformed byte. If the value is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	694	-2, -3, or -4, then the byte is the beginning of a 2, 3, or 4 byte
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	695	sequence respectively. Multi-byte sequences are sent to the convert
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	696	function pointed at in the <code>XML_Encoding</code> structure. This
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	697	function should return the Unicode scalar value for the sequence or -1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	698	if the sequence is malformed.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	699
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	700	<p>One pitfall that novice Expat users are likely to fall into is that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	701	although Expat may accept input in various encodings, the strings that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	702	it passes to the handlers are always encoded in UTF-8 or UTF-16
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	703	(depending on how Expat was compiled). Your application is responsible
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	704	for any translation of these strings into other encodings.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	705
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	706	<h3>Handling External Entity References</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	707
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	708	<p>Expat does not read or parse external entities directly. Note that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	709	any external DTD is a special case of an external entity. If you've
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	710	set no <code>ExternalEntityRefHandler</code>, then external entity
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	711	references are silently ignored. Otherwise, it calls your handler with
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	712	the information needed to read and parse the external entity.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	713
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	714	<p>Your handler isn't actually responsible for parsing the entity, but
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	715	it is responsible for creating a subsidiary parser with <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	716	"#XML_ExternalEntityParserCreate"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	717	>XML_ExternalEntityParserCreate</a></code> that will do the job. This
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	718	returns an instance of <code>XML_Parser</code> that has handlers and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	719	other data structures initialized from the parent parser. You may then
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	720	use <code><a href= "#XML_Parse" >XML_Parse</a></code> or <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	721	href= "#XML_ParseBuffer">XML_ParseBuffer</a></code> calls against this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	722	parser. Since external entities my refer to other external entities,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	723	your handler should be prepared to be called recursively.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	724
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	725	<h3>Parsing DTDs</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	726
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	727	<p>In order to parse parameter entities, before starting the parse,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	728	you must call <code><a href= "#XML_SetParamEntityParsing"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	729	>XML_SetParamEntityParsing</a></code> with one of the following
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	730	arguments:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	731	<dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	732	<dt><code>XML_PARAM_ENTITY_PARSING_NEVER</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	733	<dd>Don't parse parameter entities or the external subset</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	734	<dt><code>XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	735	<dd>Parse parameter entites and the external subset unless
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	736	<code>standalone</code> was set to "yes" in the XML declaration.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	737	<dt><code>XML_PARAM_ENTITY_PARSING_ALWAYS</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	738	<dd>Always parse parameter entities and the external subset</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	739	</dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	740
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	741	<p>In order to read an external DTD, you also have to set an external
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	742	entity reference handler as described above.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	743
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	744	<h3 id="stop-resume">Temporarily Stopping Parsing</h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	745
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	746	<p>Expat 1.95.8 introduces a new feature: its now possible to stop
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	747	parsing temporarily from within a handler function, even if more data
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	748	has already been passed into the parser. Applications for this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	749	include</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	750
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	751	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	752	<li>Supporting the <a href= "http://www.w3.org/TR/xinclude/"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	753	>XInclude</a> specification.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	754
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	755	<li>Delaying further processing until additional information is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	756	available from some other source.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	757
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	758	<li>Adjusting processor load as task priorities shift within an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	759	application.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	760
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	761	<li>Stopping parsing completely (simply free or reset the parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	762	instead of resuming in the outer parsing loop). This can be useful
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	763	if a application-domain error is found in the XML being parsed or if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	764	the result of the parse is determined not to be useful after
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	765	all.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	766	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	767
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	768	<p>To take advantage of this feature, the main parsing loop of an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	769	application needs to support this specifically. It cannot be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	770	supported with a parsing loop compatible with Expat 1.95.7 or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	771	earlier (though existing loops will continue to work without
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	772	supporting the stop/resume feature).</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	773
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	774	<p>An application that uses this feature for a single parser will have
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	775	the rough structure (in pseudo-code):</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	776
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	777	<pre class="pseudocode">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	778	fd = open_input()
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	779	p = create_parser()
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	780
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	781	if parse_xml(p, fd) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	782	/* suspended */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	783
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	784	int suspended = 1;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	785
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	786	while (suspended) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	787	do_something_else()
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	788	if ready_to_resume() {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	789	suspended = continue_parsing(p, fd);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	790	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	791	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	792	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	793	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	794
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	795	<p>An application that may resume any of several parsers based on
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	796	input (either from the XML being parsed or some other source) will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	797	certainly have more interesting control structures.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	798
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	799	<p>This C function could be used for the <code>parse_xml</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	800	function mentioned in the pseudo-code above:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	801
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	802	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	803	#define BUFF_SIZE 10240
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	804
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	805	/* Parse a document from the open file descriptor 'fd' until the parse
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	806	is complete (the document has been completely parsed, or there's
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	807	been an error), or the parse is stopped. Return non-zero when
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	808	the parse is merely suspended.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	809	*/
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	810	int
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	811	parse_xml(XML_Parser p, int fd)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	812	{
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	813	for (;;) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	814	int last_chunk;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	815	int bytes_read;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	816	enum XML_Status status;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	817
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	818	void *buff = XML_GetBuffer(p, BUFF_SIZE);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	819	if (buff == NULL) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	820	/* handle error... */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	821	return 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	822	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	823	bytes_read = read(fd, buff, BUFF_SIZE);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	824	if (bytes_read < 0) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	825	/* handle error... */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	826	return 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	827	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	828	status = XML_ParseBuffer(p, bytes_read, bytes_read == 0);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	829	switch (status) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	830	case XML_STATUS_ERROR:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	831	/* handle error... */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	832	return 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	833	case XML_STATUS_SUSPENDED:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	834	return 1;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	835	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	836	if (bytes_read == 0)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	837	return 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	838	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	839	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	840	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	841
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	842	<p>The corresponding <code>continue_parsing</code> function is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	843	somewhat simpler, since it only need deal with the return code from
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	844	<code><a href= "#XML_ResumeParser">XML_ResumeParser</a></code>; it can
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	845	delegate the input handling to the <code>parse_xml</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	846	function:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	847
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	848	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	849	/* Continue parsing a document which had been suspended. The 'p' and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	850	'fd' arguments are the same as passed to parse_xml(). Return
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	851	non-zero when the parse is suspended.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	852	*/
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	853	int
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	854	continue_parsing(XML_Parser p, int fd)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	855	{
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	856	enum XML_Status status = XML_ResumeParser(p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	857	switch (status) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	858	case XML_STATUS_ERROR:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	859	/* handle error... */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	860	return 0;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	861	case XML_ERROR_NOT_SUSPENDED:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	862	/* handle error... */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	863	return 0;.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	864	case XML_STATUS_SUSPENDED:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	865	return 1;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	866	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	867	return parse_xml(p, fd);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	868	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	869	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	870
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	871	<p>Now that we've seen what a mess the top-level parsing loop can
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	872	become, what have we gained? Very simply, we can now use the <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	873	href= "#XML_StopParser" >XML_StopParser</a></code> function to stop
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	874	parsing, without having to go to great lengths to avoid additional
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	875	processing that we're expecting to ignore. As a bonus, we get to stop
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	876	parsing <em>temporarily</em>, and come back to it when we're
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	877	ready.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	878
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	879	<p>To stop parsing from a handler function, use the <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	880	"#XML_StopParser" >XML_StopParser</a></code> function. This function
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	881	takes two arguments; the parser being stopped and a flag indicating
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	882	whether the parse can be resumed in the future.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	883
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	884	<!-- XXX really need more here -->
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	885
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	886
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	887	<hr />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	888	<!-- ================================================================ -->
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	889
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	890	<h2><a name="reference">Expat Reference</a></h2>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	891
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	892	<h3><a name="creation">Parser Creation</a></h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	893
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	894	<pre class="fcndec" id="XML_ParserCreate">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	895	XML_Parser XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	896	XML_ParserCreate(const XML_Char *encoding);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	897	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	898	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	899	Construct a new parser. If encoding is non-null, it specifies a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	900	character encoding to use for the document. This overrides the document
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	901	encoding declaration. There are four built-in encodings:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	902	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	903	<li>US-ASCII</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	904	<li>UTF-8</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	905	<li>UTF-16</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	906	<li>ISO-8859-1</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	907	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	908	Any other value will invoke a call to the UnknownEncodingHandler.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	909	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	910
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	911	<pre class="fcndec" id="XML_ParserCreateNS">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	912	XML_Parser XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	913	XML_ParserCreateNS(const XML_Char *encoding,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	914	XML_Char sep);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	915	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	916	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	917	Constructs a new parser that has namespace processing in effect. Namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	918	expanded element names and attribute names are returned as a concatenation
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	919	of the namespace URI, <em>sep</em>, and the local part of the name. This
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	920	means that you should pick a character for <em>sep</em> that can't be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	921	part of a legal URI. There is a special case when <em>sep</em> is the null
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	922	character <code>'\0'</code>: the namespace URI and the local part will be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	923	concatenated without any separator - this is intended to support RDF processors.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	924	It is a programming error to use the null separator with
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	925	<a href= "#XML_SetReturnNSTriplet">namespace triplets</a>.</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	926
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	927	<pre class="fcndec" id="XML_ParserCreate_MM">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	928	XML_Parser XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	929	XML_ParserCreate_MM(const XML_Char *encoding,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	930	const XML_Memory_Handling_Suite *ms,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	931	const XML_Char *sep);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	932	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	933	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	934	typedef struct {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	935	void (XMLCALL malloc_fcn)(size_t size);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	936	void (XMLCALL realloc_fcn)(void *ptr, size_t size);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	937	void (XMLCALL free_fcn)(void ptr);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	938	} XML_Memory_Handling_Suite;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	939	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	940	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	941	<p>Construct a new parser using the suite of memory handling functions
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	942	specified in <code>ms</code>. If <code>ms</code> is NULL, then use the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	943	standard set of memory management functions. If <code>sep</code> is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	944	non NULL, then namespace processing is enabled in the created parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	945	and the character pointed at by sep is used as the separator between
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	946	the namespace URI and the local part of the name.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	947	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	948
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	949	<pre class="fcndec" id="XML_ExternalEntityParserCreate">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	950	XML_Parser XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	951	XML_ExternalEntityParserCreate(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	952	const XML_Char *context,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	953	const XML_Char *encoding);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	954	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	955	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	956	Construct a new <code>XML_Parser</code> object for parsing an external
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	957	general entity. Context is the context argument passed in a call to a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	958	ExternalEntityRefHandler. Other state information such as handlers,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	959	user data, namespace processing is inherited from the parser passed as
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	960	the 1st argument. So you shouldn't need to call any of the behavior
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	961	changing functions on this parser (unless you want it to act
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	962	differently than the parent parser).
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	963	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	964
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	965	<pre class="fcndec" id="XML_ParserFree">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	966	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	967	XML_ParserFree(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	968	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	969	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	970	Free memory used by the parser. Your application is responsible for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	971	freeing any memory associated with <a href="#userdata">user data</a>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	972	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	973
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	974	<pre class="fcndec" id="XML_ParserReset">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	975	XML_Bool XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	976	XML_ParserReset(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	977	const XML_Char *encoding);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	978	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	979	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	980	Clean up the memory structures maintained by the parser so that it may
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	981	be used again. After this has been called, <code>parser</code> is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	982	ready to start parsing a new document. All handlers are cleared from
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	983	the parser, except for the unknownEncodingHandler. The parser's external
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	984	state is re-initialized except for the values of ns and ns_triplets.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	985	This function may not be used on a parser created using <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	986	"#XML_ExternalEntityParserCreate" >XML_ExternalEntityParserCreate</a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	987	></code>; it will return <code>XML_FALSE</code> in that case. Returns
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	988	<code>XML_TRUE</code> on success. Your application is responsible for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	989	dealing with any memory associated with <a href="#userdata">user data</a>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	990	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	991
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	992	<h3><a name="parsing">Parsing</a></h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	993
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	994	<p>To state the obvious: the three parsing functions <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	995	"#XML_Parse" >XML_Parse</a></code>, <code><a href= "#XML_ParseBuffer">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	996	XML_ParseBuffer</a></code> and <code><a href= "#XML_GetBuffer">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	997	XML_GetBuffer</a></code> must not be called from within a handler
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	998	unless they operate on a separate parser instance, that is, one that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	999	did not call the handler. For example, it is OK to call the parsing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1000	functions from within an <code>XML_ExternalEntityRefHandler</code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1001	if they apply to the parser created by
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1002	<code><a href= "#XML_ExternalEntityParserCreate"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1003	>XML_ExternalEntityParserCreate</a></code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1004
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1005	<p>Note: the <code>len</code> argument passed to these functions
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1006	should be considerably less than the maximum value for an integer,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1007	as it could create an integer overflow situation if the added
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1008	lengths of a buffer and the unprocessed portion of the previous buffer
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1009	exceed the maximum integer value. Input data at the end of a buffer
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1010	will remain unprocessed if it is part of an XML token for which the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1011	end is not part of that buffer.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1012
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1013	<pre class="fcndec" id="XML_Parse">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1014	enum XML_Status XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1015	XML_Parse(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1016	const char *s,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1017	int len,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1018	int isFinal);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1019	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1020	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1021	enum XML_Status {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1022	XML_STATUS_ERROR = 0,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1023	XML_STATUS_OK = 1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1024	};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1025	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1026	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1027	Parse some more of the document. The string <code>s</code> is a buffer
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1028	containing part (or perhaps all) of the document. The number of bytes of s
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1029	that are part of the document is indicated by <code>len</code>. This means
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1030	that <code>s</code> doesn't have to be null terminated. It also means that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1031	if <code>len</code> is larger than the number of bytes in the block of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1032	memory that <code>s</code> points at, then a memory fault is likely. The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1033	<code>isFinal</code> parameter informs the parser that this is the last
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1034	piece of the document. Frequently, the last piece is empty (i.e.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1035	<code>len</code> is zero.)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1036	If a parse error occurred, it returns <code>XML_STATUS_ERROR</code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1037	Otherwise it returns <code>XML_STATUS_OK</code> value.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1038	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1039
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1040	<pre class="fcndec" id="XML_ParseBuffer">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1041	enum XML_Status XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1042	XML_ParseBuffer(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1043	int len,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1044	int isFinal);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1045	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1046	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1047	This is just like <code><a href= "#XML_Parse" >XML_Parse</a></code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1048	except in this case Expat provides the buffer. By obtaining the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1049	buffer from Expat with the <code><a href= "#XML_GetBuffer"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1050	>XML_GetBuffer</a></code> function, the application can avoid double
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1051	copying of the input.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1052	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1053
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1054	<pre class="fcndec" id="XML_GetBuffer">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1055	void * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1056	XML_GetBuffer(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1057	int len);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1058	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1059	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1060	Obtain a buffer of size <code>len</code> to read a piece of the document
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1061	into. A NULL value is returned if Expat can't allocate enough memory for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1062	this buffer. This has to be called prior to every call to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1063	<code><a href= "#XML_ParseBuffer" >XML_ParseBuffer</a></code>. A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1064	typical use would look like this:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1065
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1066	<pre class="eg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1067	for (;;) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1068	int bytes_read;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1069	void *buff = XML_GetBuffer(p, BUFF_SIZE);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1070	if (buff == NULL) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1071	/* handle error */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1072	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1073
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1074	bytes_read = read(docfd, buff, BUFF_SIZE);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1075	if (bytes_read < 0) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1076	/* handle error */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1077	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1078
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1079	if (! XML_ParseBuffer(p, bytes_read, bytes_read == 0)) {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1080	/* handle parse error */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1081	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1082
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1083	if (bytes_read == 0)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1084	break;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1085	}
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1086	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1087	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1088
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1089	<pre class="fcndec" id="XML_StopParser">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1090	enum XML_Status XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1091	XML_StopParser(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1092	XML_Bool resumable);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1093	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1094	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1095
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1096	<p>Stops parsing, causing <code><a href= "#XML_Parse"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1097	>XML_Parse</a></code> or <code><a href= "#XML_ParseBuffer"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1098	>XML_ParseBuffer</a></code> to return. Must be called from within a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1099	call-back handler, except when aborting (when <code>resumable</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1100	is <code>XML_FALSE</code>) an already suspended parser. Some
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1101	call-backs may still follow because they would otherwise get
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1102	lost, including
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1103	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1104	<li> the end element handler for empty elements when stopped in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1105	start element handler,</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1106	<li> end namespace declaration handler when stopped in the end
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1107	element handler,</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1108	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1109	and possibly others.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1110
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1111	<p>This can be called from most handlers, including DTD related
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1112	call-backs, except when parsing an external parameter entity and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1113	<code>resumable</code> is <code>XML_TRUE</code>. Returns
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1114	<code>XML_STATUS_OK</code> when successful,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1115	<code>XML_STATUS_ERROR</code> otherwise. The possible error codes
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1116	are:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1117	<dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1118	<dt><code>XML_ERROR_SUSPENDED</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1119	<dd>when suspending an already suspended parser.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1120	<dt><code>XML_ERROR_FINISHED</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1121	<dd>when the parser has already finished.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1122	<dt><code>XML_ERROR_SUSPEND_PE</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1123	<dd>when suspending while parsing an external PE.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1124	</dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1125
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1126	<p>Since the stop/resume feature requires application support in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1127	outer parsing loop, it is an error to call this function for a parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1128	not being handled appropriately; see <a href= "#stop-resume"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1129	>Temporarily Stopping Parsing</a> for more information.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1130
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1131	<p>When <code>resumable</code> is <code>XML_TRUE</code> then parsing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1132	is <em>suspended</em>, that is, <code><a href= "#XML_Parse"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1133	>XML_Parse</a></code> and <code><a href= "#XML_ParseBuffer"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1134	>XML_ParseBuffer</a></code> return <code>XML_STATUS_SUSPENDED</code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1135	Otherwise, parsing is <em>aborted</em>, that is, <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1136	"#XML_Parse" >XML_Parse</a></code> and <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1137	"#XML_ParseBuffer" >XML_ParseBuffer</a></code> return
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1138	<code>XML_STATUS_ERROR</code> with error code
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1139	<code>XML_ERROR_ABORTED</code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1140
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1141	<p><strong>Note:</strong>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1142	This will be applied to the current parser instance only, that is, if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1143	there is a parent parser then it will continue parsing when the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1144	external entity reference handler returns. It is up to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1145	implementation of that handler to call <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1146	"#XML_StopParser" >XML_StopParser</a></code> on the parent parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1147	(recursively), if one wants to stop parsing altogether.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1148
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1149	<p>When suspended, parsing can be resumed by calling <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1150	"#XML_ResumeParser" >XML_ResumeParser</a></code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1151
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1152	<p>New in Expat 1.95.8.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1153	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1154
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1155	<pre class="fcndec" id="XML_ResumeParser">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1156	enum XML_Status XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1157	XML_ResumeParser(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1158	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1159	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1160	<p>Resumes parsing after it has been suspended with <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1161	"#XML_StopParser" >XML_StopParser</a></code>. Must not be called from
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1162	within a handler call-back. Returns same status codes as <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1163	href= "#XML_Parse">XML_Parse</a></code> or <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1164	"#XML_ParseBuffer" >XML_ParseBuffer</a></code>. An additional error
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1165	code, <code>XML_ERROR_NOT_SUSPENDED</code>, will be returned if the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1166	parser was not currently suspended.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1167
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1168	<p><strong>Note:</strong>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1169	This must be called on the most deeply nested child parser instance
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1170	first, and on its parent parser only after the child parser has
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1171	finished, to be applied recursively until the document entity's parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1172	is restarted. That is, the parent parser will not resume by itself
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1173	and it is up to the application to call <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1174	"#XML_ResumeParser" >XML_ResumeParser</a></code> on it at the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1175	appropriate moment.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1176
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1177	<p>New in Expat 1.95.8.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1178	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1179
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1180	<pre class="fcndec" id="XML_GetParsingStatus">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1181	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1182	XML_GetParsingStatus(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1183	XML_ParsingStatus *status);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1184	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1185	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1186	enum XML_Parsing {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1187	XML_INITIALIZED,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1188	XML_PARSING,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1189	XML_FINISHED,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1190	XML_SUSPENDED
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1191	};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1192
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1193	typedef struct {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1194	enum XML_Parsing parsing;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1195	XML_Bool finalBuffer;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1196	} XML_ParsingStatus;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1197	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1198	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1199	<p>Returns status of parser with respect to being initialized,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1200	parsing, finished, or suspended, and whether the final buffer is being
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1201	processed. The <code>status</code> parameter <em>must not</em> be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1202	NULL.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1203
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1204	<p>New in Expat 1.95.8.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1205	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1206
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1207
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1208	<h3><a name="setting">Handler Setting</a></h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1209
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1210	<p>Although handlers are typically set prior to parsing and left alone, an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1211	application may choose to set or change the handler for a parsing event
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1212	while the parse is in progress. For instance, your application may choose
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1213	to ignore all text not descended from a <code>para</code> element. One
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1214	way it could do this is to set the character handler when a para start tag
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1215	is seen, and unset it for the corresponding end tag.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1216
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1217	<p>A handler may be <em>unset</em> by providing a NULL pointer to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1218	appropriate handler setter. None of the handler setting functions have
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1219	a return value.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1220
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1221	<p>Your handlers will be receiving strings in arrays of type
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1222	<code>XML_Char</code>. This type is conditionally defined in expat.h as
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1223	either <code>char</code>, <code>wchar_t</code> or <code>unsigned short</code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1224	The former implies UTF-8 encoding, the latter two imply UTF-16 encoding.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1225	Note that you'll receive them in this form independent of the original
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1226	encoding of the document.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1227
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1228	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1229	<pre class="setter" id="XML_SetStartElementHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1230	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1231	XML_SetStartElementHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1232	XML_StartElementHandler start);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1233	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1234	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1235	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1236	(XMLCALL XML_StartElementHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1237	const XML_Char *name,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1238	const XML_Char **atts);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1239	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1240	<p>Set handler for start (and empty) tags. Attributes are passed to the start
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1241	handler as a pointer to a vector of char pointers. Each attribute seen in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1242	a start (or empty) tag occupies 2 consecutive places in this vector: the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1243	attribute name followed by the attribute value. These pairs are terminated
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1244	by a null pointer.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1245	<p>Note that an empty tag generates a call to both start and end handlers
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1246	(in that order).</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1247	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1248
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1249	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1250	<pre class="setter" id="XML_SetEndElementHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1251	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1252	XML_SetEndElementHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1253	XML_EndElementHandler);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1254	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1255	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1256	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1257	(XMLCALL XML_EndElementHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1258	const XML_Char *name);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1259	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1260	<p>Set handler for end (and empty) tags. As noted above, an empty tag
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1261	generates a call to both start and end handlers.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1262	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1263
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1264	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1265	<pre class="setter" id="XML_SetElementHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1266	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1267	XML_SetElementHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1268	XML_StartElementHandler start,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1269	XML_EndElementHandler end);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1270	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1271	<p>Set handlers for start and end tags with one call.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1272	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1273
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1274	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1275	<pre class="setter" id="XML_SetCharacterDataHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1276	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1277	XML_SetCharacterDataHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1278	XML_CharacterDataHandler charhndl)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1279	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1280	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1281	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1282	(XMLCALL XML_CharacterDataHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1283	const XML_Char *s,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1284	int len);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1285	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1286	<p>Set a text handler. The string your handler receives
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1287	is <em>NOT nul-terminated</em>. You have to use the length argument
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1288	to deal with the end of the string. A single block of contiguous text
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1289	free of markup may still result in a sequence of calls to this handler.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1290	In other words, if you're searching for a pattern in the text, it may
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1291	be split across calls to this handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1292	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1293
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1294	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1295	<pre class="setter" id="XML_SetProcessingInstructionHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1296	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1297	XML_SetProcessingInstructionHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1298	XML_ProcessingInstructionHandler proc)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1299	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1300	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1301	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1302	(XMLCALL XML_ProcessingInstructionHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1303	const XML_Char *target,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1304	const XML_Char *data);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1305
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1306	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1307	<p>Set a handler for processing instructions. The target is the first word
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1308	in the processing instruction. The data is the rest of the characters in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1309	it after skipping all whitespace after the initial word.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1310	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1311
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1312	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1313	<pre class="setter" id="XML_SetCommentHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1314	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1315	XML_SetCommentHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1316	XML_CommentHandler cmnt)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1317	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1318	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1319	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1320	(XMLCALL XML_CommentHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1321	const XML_Char *data);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1322	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1323	<p>Set a handler for comments. The data is all text inside the comment
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1324	delimiters.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1325	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1326
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1327	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1328	<pre class="setter" id="XML_SetStartCdataSectionHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1329	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1330	XML_SetStartCdataSectionHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1331	XML_StartCdataSectionHandler start);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1332	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1333	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1334	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1335	(XMLCALL XML_StartCdataSectionHandler)(void userData);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1336	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1337	<p>Set a handler that gets called at the beginning of a CDATA section.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1338	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1339
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1340	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1341	<pre class="setter" id="XML_SetEndCdataSectionHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1342	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1343	XML_SetEndCdataSectionHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1344	XML_EndCdataSectionHandler end);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1345	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1346	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1347	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1348	(XMLCALL XML_EndCdataSectionHandler)(void userData);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1349	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1350	<p>Set a handler that gets called at the end of a CDATA section.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1351	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1352
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1353	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1354	<pre class="setter" id="XML_SetCdataSectionHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1355	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1356	XML_SetCdataSectionHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1357	XML_StartCdataSectionHandler start,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1358	XML_EndCdataSectionHandler end)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1359	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1360	<p>Sets both CDATA section handlers with one call.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1361	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1362
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1363	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1364	<pre class="setter" id="XML_SetDefaultHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1365	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1366	XML_SetDefaultHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1367	XML_DefaultHandler hndl)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1368	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1369	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1370	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1371	(XMLCALL XML_DefaultHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1372	const XML_Char *s,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1373	int len);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1374	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1375
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1376	<p>Sets a handler for any characters in the document which wouldn't
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1377	otherwise be handled. This includes both data for which no handlers
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1378	can be set (like some kinds of DTD declarations) and data which could
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1379	be reported but which currently has no handler set. The characters
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1380	are passed exactly as they were present in the XML document except
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1381	that they will be encoded in UTF-8 or UTF-16. Line boundaries are not
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1382	normalized. Note that a byte order mark character is not passed to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1383	default handler. There are no guarantees about how characters are
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1384	divided between calls to the default handler: for example, a comment
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1385	might be split between multiple calls. Setting the handler with
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1386	this call has the side effect of turning off expansion of references
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1387	to internally defined general entities. Instead these references are
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1388	passed to the default handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1389
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1390	<p>See also <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1391	href="#XML_DefaultCurrent">XML_DefaultCurrent</a></code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1392	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1393
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1394	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1395	<pre class="setter" id="XML_SetDefaultHandlerExpand">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1396	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1397	XML_SetDefaultHandlerExpand(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1398	XML_DefaultHandler hndl)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1399	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1400	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1401	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1402	(XMLCALL XML_DefaultHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1403	const XML_Char *s,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1404	int len);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1405	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1406	<p>This sets a default handler, but doesn't inhibit the expansion of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1407	internal entity references. The entity reference will not be passed
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1408	to the default handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1409
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1410	<p>See also <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1411	href="#XML_DefaultCurrent">XML_DefaultCurrent</a></code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1412	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1413
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1414	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1415	<pre class="setter" id="XML_SetExternalEntityRefHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1416	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1417	XML_SetExternalEntityRefHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1418	XML_ExternalEntityRefHandler hndl)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1419	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1420	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1421	typedef int
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1422	(XMLCALL *XML_ExternalEntityRefHandler)(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1423	const XML_Char *context,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1424	const XML_Char *base,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1425	const XML_Char *systemId,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1426	const XML_Char *publicId);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1427	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1428	<p>Set an external entity reference handler. This handler is also
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1429	called for processing an external DTD subset if parameter entity parsing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1430	is in effect. (See <a href="#XML_SetParamEntityParsing">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1431	<code>XML_SetParamEntityParsing</code></a>.)</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1432
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1433	<p>The <code>context</code> parameter specifies the parsing context in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1434	the format expected by the <code>context</code> argument to <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1435	href="#XML_ExternalEntityParserCreate"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1436	>XML_ExternalEntityParserCreate</a></code>. <code>code</code> is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1437	valid only until the handler returns, so if the referenced entity is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1438	to be parsed later, it must be copied. <code>context</code> is NULL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1439	only when the entity is a parameter entity, which is how one can
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1440	differentiate between general and parameter entities.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1441
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1442	<p>The <code>base</code> parameter is the base to use for relative
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1443	system identifiers. It is set by <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1444	href="#XML_SetBase">XML_SetBase</a></code> and may be NULL. The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1445	<code>publicId</code> parameter is the public id given in the entity
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1446	declaration and may be NULL. <code>systemId</code> is the system
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1447	identifier specified in the entity declaration and is never NULL.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1448
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1449	<p>There are a couple of ways in which this handler differs from
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1450	others. First, this handler returns a status indicator (an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1451	integer). <code>XML_STATUS_OK</code> should be returned for successful
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1452	handling of the external entity reference. Returning
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1453	<code>XML_STATUS_ERROR</code> indicates failure, and causes the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1454	calling parser to return an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1455	<code>XML_ERROR_EXTERNAL_ENTITY_HANDLING</code> error.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1456
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1457	<p>Second, instead of having the user data as its first argument, it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1458	receives the parser that encountered the entity reference. This, along
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1459	with the context parameter, may be used as arguments to a call to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1460	<code><a href= "#XML_ExternalEntityParserCreate"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1461	>XML_ExternalEntityParserCreate</a></code>. Using the returned
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1462	parser, the body of the external entity can be recursively parsed.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1463
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1464	<p>Since this handler may be called recursively, it should not be saving
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1465	information into global or static variables.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1466	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1467
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1468	<pre class="fcndec" id="XML_SetExternalEntityRefHandlerArg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1469	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1470	XML_SetExternalEntityRefHandlerArg(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1471	void *arg)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1472	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1473	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1474	<p>Set the argument passed to the ExternalEntityRefHandler. If
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1475	<code>arg</code> is not NULL, it is the new value passed to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1476	handler set using <code><a href="#XML_SetExternalEntityRefHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1477	>XML_SetExternalEntityRefHandler</a></code>; if <code>arg</code> is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1478	NULL, the argument passed to the handler function will be the parser
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1479	object itself.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1480
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1481	<p><strong>Note:</strong>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1482	The type of <code>arg</code> and the type of the first argument to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1483	ExternalEntityRefHandler do not match. This function takes a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1484	<code>void *</code> to be passed to the handler, while the handler
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1485	accepts an <code>XML_Parser</code>. This is a historical accident,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1486	but will not be corrected before Expat 2.0 (at the earliest) to avoid
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1487	causing compiler warnings for code that's known to work with this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1488	API. It is the responsibility of the application code to know the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1489	actual type of the argument passed to the handler and to manage it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1490	properly.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1491	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1492
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1493	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1494	<pre class="setter" id="XML_SetSkippedEntityHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1495	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1496	XML_SetSkippedEntityHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1497	XML_SkippedEntityHandler handler)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1498	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1499	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1500	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1501	(XMLCALL XML_SkippedEntityHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1502	const XML_Char *entityName,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1503	int is_parameter_entity);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1504	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1505	<p>Set a skipped entity handler. This is called in two situations:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1506	<ol>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1507	<li>An entity reference is encountered for which no declaration
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1508	has been read <em>and</em> this is not an error.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1509	<li>An internal entity reference is read, but not expanded, because
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1510	<a href="#XML_SetDefaultHandler"><code>XML_SetDefaultHandler</code></a>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1511	has been called.</li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1512	</ol>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1513	<p>The <code>is_parameter_entity</code> argument will be non-zero for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1514	a parameter entity and zero for a general entity.</p> <p>Note: skipped
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1515	parameter entities in declarations and skipped general entities in
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1516	attribute values cannot be reported, because the event would be out of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1517	sync with the reporting of the declarations or attribute values</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1518	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1519
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1520	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1521	<pre class="setter" id="XML_SetUnknownEncodingHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1522	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1523	XML_SetUnknownEncodingHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1524	XML_UnknownEncodingHandler enchandler,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1525	void *encodingHandlerData)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1526	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1527	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1528	typedef int
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1529	(XMLCALL XML_UnknownEncodingHandler)(void encodingHandlerData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1530	const XML_Char *name,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1531	XML_Encoding *info);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1532
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1533	typedef struct {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1534	int map[256];
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1535	void *data;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1536	int (XMLCALL convert)(void data, const char *s);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1537	void (XMLCALL release)(void data);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1538	} XML_Encoding;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1539	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1540	<p>Set a handler to deal with encodings other than the <a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1541	href="#builtin_encodings">built in set</a>. This should be done before
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1542	<code><a href= "#XML_Parse" >XML_Parse</a></code> or <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1543	"#XML_ParseBuffer" >XML_ParseBuffer</a></code> have been called on the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1544	given parser.</p> <p>If the handler knows how to deal with an encoding
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1545	with the given name, it should fill in the <code>info</code> data
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1546	structure and return <code>XML_STATUS_OK</code>. Otherwise it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1547	should return <code>XML_STATUS_ERROR</code>. The handler will be called
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1548	at most once per parsed (external) entity. The optional application
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1549	data pointer <code>encodingHandlerData</code> will be passed back to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1550	the handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1551
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1552	<p>The map array contains information for every possible possible leading
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1553	byte in a byte sequence. If the corresponding value is >= 0, then it's
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1554	a single byte sequence and the byte encodes that Unicode value. If the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1555	value is -1, then that byte is invalid as the initial byte in a sequence.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1556	If the value is -n, where n is an integer > 1, then n is the number of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1557	bytes in the sequence and the actual conversion is accomplished by a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1558	call to the function pointed at by convert. This function may return -1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1559	if the sequence itself is invalid. The convert pointer may be null if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1560	there are only single byte codes. The data parameter passed to the convert
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1561	function is the data pointer from <code>XML_Encoding</code>. The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1562	string s is <em>NOT</em> nul-terminated and points at the sequence of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1563	bytes to be converted.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1564
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1565	<p>The function pointed at by <code>release</code> is called by the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1566	parser when it is finished with the encoding. It may be NULL.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1567	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1568
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1569	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1570	<pre class="setter" id="XML_SetStartNamespaceDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1571	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1572	XML_SetStartNamespaceDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1573	XML_StartNamespaceDeclHandler start);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1574	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1575	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1576	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1577	(XMLCALL XML_StartNamespaceDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1578	const XML_Char *prefix,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1579	const XML_Char *uri);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1580	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1581	<p>Set a handler to be called when a namespace is declared. Namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1582	declarations occur inside start tags. But the namespace declaration start
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1583	handler is called before the start tag handler for each namespace declared
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1584	in that start tag.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1585	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1586
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1587	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1588	<pre class="setter" id="XML_SetEndNamespaceDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1589	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1590	XML_SetEndNamespaceDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1591	XML_EndNamespaceDeclHandler end);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1592	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1593	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1594	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1595	(XMLCALL XML_EndNamespaceDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1596	const XML_Char *prefix);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1597	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1598	<p>Set a handler to be called when leaving the scope of a namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1599	declaration. This will be called, for each namespace declaration,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1600	after the handler for the end tag of the element in which the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1601	namespace was declared.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1602	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1603
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1604	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1605	<pre class="setter" id="XML_SetNamespaceDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1606	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1607	XML_SetNamespaceDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1608	XML_StartNamespaceDeclHandler start,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1609	XML_EndNamespaceDeclHandler end)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1610	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1611	<p>Sets both namespace declaration handlers with a single call.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1612	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1613
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1614	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1615	<pre class="setter" id="XML_SetXmlDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1616	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1617	XML_SetXmlDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1618	XML_XmlDeclHandler xmldecl);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1619	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1620	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1621	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1622	(XMLCALL XML_XmlDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1623	const XML_Char *version,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1624	const XML_Char *encoding,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1625	int standalone);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1626	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1627	<p>Sets a handler that is called for XML declarations and also for
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1628	text declarations discovered in external entities. The way to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1629	distinguish is that the <code>version</code> parameter will be NULL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1630	for text declarations. The <code>encoding</code> parameter may be NULL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1631	for an XML declaration. The <code>standalone</code> argument will
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1632	contain -1, 0, or 1 indicating respectively that there was no
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1633	standalone parameter in the declaration, that it was given as no, or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1634	that it was given as yes.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1635	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1636
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1637	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1638	<pre class="setter" id="XML_SetStartDoctypeDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1639	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1640	XML_SetStartDoctypeDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1641	XML_StartDoctypeDeclHandler start);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1642	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1643	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1644	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1645	(XMLCALL XML_StartDoctypeDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1646	const XML_Char *doctypeName,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1647	const XML_Char *sysid,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1648	const XML_Char *pubid,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1649	int has_internal_subset);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1650	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1651	<p>Set a handler that is called at the start of a DOCTYPE declaration,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1652	before any external or internal subset is parsed. Both <code>sysid</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1653	and <code>pubid</code> may be NULL. The <code>has_internal_subset</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1654	will be non-zero if the DOCTYPE declaration has an internal subset.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1655	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1656
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1657	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1658	<pre class="setter" id="XML_SetEndDoctypeDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1659	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1660	XML_SetEndDoctypeDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1661	XML_EndDoctypeDeclHandler end);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1662	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1663	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1664	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1665	(XMLCALL XML_EndDoctypeDeclHandler)(void userData);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1666	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1667	<p>Set a handler that is called at the end of a DOCTYPE declaration,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1668	after parsing any external subset.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1669	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1670
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1671	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1672	<pre class="setter" id="XML_SetDoctypeDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1673	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1674	XML_SetDoctypeDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1675	XML_StartDoctypeDeclHandler start,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1676	XML_EndDoctypeDeclHandler end);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1677	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1678	<p>Set both doctype handlers with one call.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1679	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1680
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1681	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1682	<pre class="setter" id="XML_SetElementDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1683	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1684	XML_SetElementDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1685	XML_ElementDeclHandler eldecl);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1686	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1687	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1688	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1689	(XMLCALL XML_ElementDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1690	const XML_Char *name,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1691	XML_Content *model);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1692	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1693	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1694	enum XML_Content_Type {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1695	XML_CTYPE_EMPTY = 1,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1696	XML_CTYPE_ANY,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1697	XML_CTYPE_MIXED,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1698	XML_CTYPE_NAME,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1699	XML_CTYPE_CHOICE,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1700	XML_CTYPE_SEQ
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1701	};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1702
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1703	enum XML_Content_Quant {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1704	XML_CQUANT_NONE,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1705	XML_CQUANT_OPT,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1706	XML_CQUANT_REP,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1707	XML_CQUANT_PLUS
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1708	};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1709
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1710	typedef struct XML_cp XML_Content;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1711
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1712	struct XML_cp {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1713	enum XML_Content_Type type;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1714	enum XML_Content_Quant quant;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1715	const XML_Char * name;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1716	unsigned int numchildren;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1717	XML_Content * children;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1718	};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1719	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1720	<p>Sets a handler for element declarations in a DTD. The handler gets
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1721	called with the name of the element in the declaration and a pointer
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1722	to a structure that contains the element model. It is the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1723	application's responsibility to free this data structure using
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1724	<code><a href="#XML_FreeContentModel"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1725	>XML_FreeContentModel</a></code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1726
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1727	<p>The <code>model</code> argument is the root of a tree of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1728	<code>XML_Content</code> nodes. If <code>type</code> equals
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1729	<code>XML_CTYPE_EMPTY</code> or <code>XML_CTYPE_ANY</code>, then
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1730	<code>quant</code> will be <code>XML_CQUANT_NONE</code>, and the other
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1731	fields will be zero or NULL. If <code>type</code> is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1732	<code>XML_CTYPE_MIXED</code>, then <code>quant</code> will be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1733	<code>XML_CQUANT_NONE</code> or <code>XML_CQUANT_REP</code> and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1734	<code>numchildren</code> will contain the number of elements that are
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1735	allowed to be mixed in and <code>children</code> points to an array of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1736	<code>XML_Content</code> structures that will all have type
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1737	XML_CTYPE_NAME with no quantification. Only the root node can be type
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1738	<code>XML_CTYPE_EMPTY</code>, <code>XML_CTYPE_ANY</code>, or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1739	<code>XML_CTYPE_MIXED</code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1740
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1741	<p>For type <code>XML_CTYPE_NAME</code>, the <code>name</code> field
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1742	points to the name and the <code>numchildren</code> and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1743	<code>children</code> fields will be zero and NULL. The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1744	<code>quant</code> field will indicate any quantifiers placed on the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1745	name.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1746
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1747	<p>Types <code>XML_CTYPE_CHOICE</code> and <code>XML_CTYPE_SEQ</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1748	indicate a choice or sequence respectively. The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1749	<code>numchildren</code> field indicates how many nodes in the choice
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1750	or sequence and <code>children</code> points to the nodes.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1751	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1752
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1753	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1754	<pre class="setter" id="XML_SetAttlistDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1755	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1756	XML_SetAttlistDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1757	XML_AttlistDeclHandler attdecl);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1758	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1759	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1760	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1761	(XMLCALL XML_AttlistDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1762	const XML_Char *elname,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1763	const XML_Char *attname,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1764	const XML_Char *att_type,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1765	const XML_Char *dflt,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1766	int isrequired);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1767	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1768	<p>Set a handler for attlist declarations in the DTD. This handler is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1769	called for <em>each</em> attribute. So a single attlist declaration
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1770	with multiple attributes declared will generate multiple calls to this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1771	handler. The <code>elname</code> parameter returns the name of the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1772	element for which the attribute is being declared. The attribute name
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1773	is in the <code>attname</code> parameter. The attribute type is in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1774	<code>att_type</code> parameter. It is the string representing the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1775	type in the declaration with whitespace removed.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1776
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1777	<p>The <code>dflt</code> parameter holds the default value. It will be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1778	NULL in the case of "#IMPLIED" or "#REQUIRED" attributes. You can
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1779	distinguish these two cases by checking the <code>isrequired</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1780	parameter, which will be true in the case of "#REQUIRED" attributes.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1781	Attributes which are "#FIXED" will have also have a true
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1782	<code>isrequired</code>, but they will have the non-NULL fixed value
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1783	in the <code>dflt</code> parameter.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1784	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1785
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1786	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1787	<pre class="setter" id="XML_SetEntityDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1788	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1789	XML_SetEntityDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1790	XML_EntityDeclHandler handler);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1791	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1792	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1793	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1794	(XMLCALL XML_EntityDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1795	const XML_Char *entityName,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1796	int is_parameter_entity,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1797	const XML_Char *value,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1798	int value_length,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1799	const XML_Char *base,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1800	const XML_Char *systemId,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1801	const XML_Char *publicId,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1802	const XML_Char *notationName);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1803	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1804	<p>Sets a handler that will be called for all entity declarations.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1805	The <code>is_parameter_entity</code> argument will be non-zero in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1806	case of parameter entities and zero otherwise.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1807
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1808	<p>For internal entities (<code><!ENTITY foo "bar"></code>),
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1809	<code>value</code> will be non-NULL and <code>systemId</code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1810	<code>publicId</code>, and <code>notationName</code> will all be NULL.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1811	The value string is <em>not</em> NULL terminated; the length is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1812	provided in the <code>value_length</code> parameter. Do not use
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1813	<code>value_length</code> to test for internal entities, since it is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1814	legal to have zero-length values. Instead check for whether or not
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1815	<code>value</code> is NULL.</p> <p>The <code>notationName</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1816	argument will have a non-NULL value only for unparsed entity
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1817	declarations.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1818	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1819
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1820	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1821	<pre class="setter" id="XML_SetUnparsedEntityDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1822	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1823	XML_SetUnparsedEntityDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1824	XML_UnparsedEntityDeclHandler h)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1825	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1826	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1827	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1828	(XMLCALL XML_UnparsedEntityDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1829	const XML_Char *entityName,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1830	const XML_Char *base,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1831	const XML_Char *systemId,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1832	const XML_Char *publicId,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1833	const XML_Char *notationName);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1834	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1835	<p>Set a handler that receives declarations of unparsed entities. These
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1836	are entity declarations that have a notation (NDATA) field:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1837
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1838	<div id="eg"><pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1839	<!ENTITY logo SYSTEM "images/logo.gif" NDATA gif>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1840	</pre></div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1841	<p>This handler is obsolete and is provided for backwards
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1842	compatibility. Use instead <a href= "#XML_SetEntityDeclHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1843	>XML_SetEntityDeclHandler</a>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1844	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1845
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1846	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1847	<pre class="setter" id="XML_SetNotationDeclHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1848	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1849	XML_SetNotationDeclHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1850	XML_NotationDeclHandler h)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1851	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1852	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1853	typedef void
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1854	(XMLCALL XML_NotationDeclHandler)(void userData,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1855	const XML_Char *notationName,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1856	const XML_Char *base,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1857	const XML_Char *systemId,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1858	const XML_Char *publicId);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1859	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1860	<p>Set a handler that receives notation declarations.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1861	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1862
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1863	<div class="handler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1864	<pre class="setter" id="XML_SetNotStandaloneHandler">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1865	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1866	XML_SetNotStandaloneHandler(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1867	XML_NotStandaloneHandler h)
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1868	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1869	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1870	typedef int
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1871	(XMLCALL XML_NotStandaloneHandler)(void userData);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1872	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1873	<p>Set a handler that is called if the document is not "standalone".
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1874	This happens when there is an external subset or a reference to a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1875	parameter entity, but does not have standalone set to "yes" in an XML
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1876	declaration. If this handler returns <code>XML_STATUS_ERROR</code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1877	then the parser will throw an <code>XML_ERROR_NOT_STANDALONE</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1878	error.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1879	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1880
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1881	<h3><a name="position">Parse position and error reporting functions</a></h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1882
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1883	<p>These are the functions you'll want to call when the parse
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1884	functions return <code>XML_STATUS_ERROR</code> (a parse error has
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1885	occurred), although the position reporting functions are useful outside
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1886	of errors. The position reported is the byte position (in the original
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1887	document or entity encoding) of the first of the sequence of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1888	characters that generated the current event (or the error that caused
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1889	the parse functions to return <code>XML_STATUS_ERROR</code>.) The
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1890	exceptions are callbacks trigged by declarations in the document
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1891	prologue, in which case they exact position reported is somewhere in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1892	relevant markup, but not necessarily as meaningful as for other
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1893	events.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1894
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1895	<p>The position reporting functions are accurate only outside of the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1896	DTD. In other words, they usually return bogus information when
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1897	called from within a DTD declaration handler.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1898
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1899	<pre class="fcndec" id="XML_GetErrorCode">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1900	enum XML_Error XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1901	XML_GetErrorCode(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1902	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1903	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1904	Return what type of error has occurred.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1905	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1906
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1907	<pre class="fcndec" id="XML_ErrorString">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1908	const XML_LChar * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1909	XML_ErrorString(enum XML_Error code);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1910	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1911	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1912	Return a string describing the error corresponding to code.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1913	The code should be one of the enums that can be returned from
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1914	<code><a href= "#XML_GetErrorCode" >XML_GetErrorCode</a></code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1915	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1916
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1917	<pre class="fcndec" id="XML_GetCurrentByteIndex">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1918	XML_Index XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1919	XML_GetCurrentByteIndex(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1920	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1921	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1922	Return the byte offset of the position. This always corresponds to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1923	the values returned by <code><a href= "#XML_GetCurrentLineNumber"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1924	>XML_GetCurrentLineNumber</a></code> and <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1925	"#XML_GetCurrentColumnNumber" >XML_GetCurrentColumnNumber</a></code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1926	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1927
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1928	<pre class="fcndec" id="XML_GetCurrentLineNumber">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1929	XML_Size XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1930	XML_GetCurrentLineNumber(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1931	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1932	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1933	Return the line number of the position. The first line is reported as
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1934	<code>1</code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1935	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1936
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1937	<pre class="fcndec" id="XML_GetCurrentColumnNumber">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1938	XML_Size XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1939	XML_GetCurrentColumnNumber(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1940	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1941	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1942	Return the offset, from the beginning of the current line, of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1943	the position.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1944	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1945
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1946	<pre class="fcndec" id="XML_GetCurrentByteCount">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1947	int XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1948	XML_GetCurrentByteCount(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1949	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1950	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1951	Return the number of bytes in the current event. Returns
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1952	<code>0</code> if the event is inside a reference to an internal
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1953	entity and for the end-tag event for empty element tags (the later can
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1954	be used to distinguish empty-element tags from empty elements using
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1955	separate start and end tags).
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1956	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1957
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1958	<pre class="fcndec" id="XML_GetInputContext">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1959	const char * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1960	XML_GetInputContext(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1961	int *offset,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1962	int *size);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1963	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1964	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1965
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1966	<p>Returns the parser's input buffer, sets the integer pointed at by
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1967	<code>offset</code> to the offset within this buffer of the current
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1968	parse position, and set the integer pointed at by <code>size</code> to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1969	the size of the returned buffer.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1970
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1971	<p>This should only be called from within a handler during an active
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1972	parse and the returned buffer should only be referred to from within
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1973	the handler that made the call. This input buffer contains the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1974	untranslated bytes of the input.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1975
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1976	<p>Only a limited amount of context is kept, so if the event
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1977	triggering a call spans over a very large amount of input, the actual
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1978	parse position may be before the beginning of the buffer.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1979
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1980	<p>If <code>XML_CONTEXT_BYTES</code> is not defined, this will always
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1981	return NULL.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1982	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1983
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1984	<h3><a name="miscellaneous">Miscellaneous functions</a></h3>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1985
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1986	<p>The functions in this section either obtain state information from
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1987	the parser or can be used to dynamicly set parser options.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1988
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1989	<pre class="fcndec" id="XML_SetUserData">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1990	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1991	XML_SetUserData(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1992	void *userData);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1993	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1994	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1995	This sets the user data pointer that gets passed to handlers. It
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1996	overwrites any previous value for this pointer. Note that the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1997	application is responsible for freeing the memory associated with
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1998	<code>userData</code> when it is finished with the parser. So if you
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	1999	call this when there's already a pointer there, and you haven't freed
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2000	the memory associated with it, then you've probably just leaked
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2001	memory.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2002	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2003
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2004	<pre class="fcndec" id="XML_GetUserData">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2005	void * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2006	XML_GetUserData(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2007	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2008	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2009	This returns the user data pointer that gets passed to handlers.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2010	It is actually implemented as a macro.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2011	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2012
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2013	<pre class="fcndec" id="XML_UseParserAsHandlerArg">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2014	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2015	XML_UseParserAsHandlerArg(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2016	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2017	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2018	After this is called, handlers receive the parser in their
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2019	<code>userData</code> arguments. The user data can still be obtained
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2020	using the <code><a href= "#XML_GetUserData"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2021	>XML_GetUserData</a></code> function.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2022	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2023
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2024	<pre class="fcndec" id="XML_SetBase">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2025	enum XML_Status XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2026	XML_SetBase(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2027	const XML_Char *base);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2028	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2029	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2030	Set the base to be used for resolving relative URIs in system
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2031	identifiers. The return value is <code>XML_STATUS_ERROR</code> if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2032	there's no memory to store base, otherwise it's
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2033	<code>XML_STATUS_OK</code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2034	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2035
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2036	<pre class="fcndec" id="XML_GetBase">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2037	const XML_Char * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2038	XML_GetBase(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2039	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2040	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2041	Return the base for resolving relative URIs.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2042	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2043
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2044	<pre class="fcndec" id="XML_GetSpecifiedAttributeCount">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2045	int XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2046	XML_GetSpecifiedAttributeCount(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2047	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2048	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2049	When attributes are reported to the start handler in the atts vector,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2050	attributes that were explicitly set in the element occur before any
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2051	attributes that receive their value from default information in an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2052	ATTLIST declaration. This function returns the number of attributes
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2053	that were explicitly set times two, thus giving the offset in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2054	<code>atts</code> array passed to the start tag handler of the first
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2055	attribute set due to defaults. It supplies information for the last
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2056	call to a start handler. If called inside a start handler, then that
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2057	means the current call.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2058	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2059
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2060	<pre class="fcndec" id="XML_GetIdAttributeIndex">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2061	int XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2062	XML_GetIdAttributeIndex(XML_Parser p);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2063	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2064	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2065	Returns the index of the ID attribute passed in the atts array in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2066	last call to <code><a href= "#XML_StartElementHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2067	>XML_StartElementHandler</a></code>, or -1 if there is no ID
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2068	attribute. If called inside a start handler, then that means the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2069	current call.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2070	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2071
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2072	<pre class="fcndec" id="XML_SetEncoding">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2073	enum XML_Status XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2074	XML_SetEncoding(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2075	const XML_Char *encoding);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2076	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2077	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2078	Set the encoding to be used by the parser. It is equivalent to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2079	passing a non-null encoding argument to the parser creation functions.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2080	It must not be called after <code><a href= "#XML_Parse"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2081	>XML_Parse</a></code> or <code><a href= "#XML_ParseBuffer"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2082	>XML_ParseBuffer</a></code> have been called on the given parser.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2083	Returns <code>XML_STATUS_OK</code> on success or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2084	<code>XML_STATUS_ERROR</code> on error.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2085	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2086
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2087	<pre class="fcndec" id="XML_SetParamEntityParsing">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2088	int XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2089	XML_SetParamEntityParsing(XML_Parser p,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2090	enum XML_ParamEntityParsing code);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2091	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2092	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2093	This enables parsing of parameter entities, including the external
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2094	parameter entity that is the external DTD subset, according to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2095	<code>code</code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2096	The choices for <code>code</code> are:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2097	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2098	<li><code>XML_PARAM_ENTITY_PARSING_NEVER</code></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2099	<li><code>XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE</code></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2100	<li><code>XML_PARAM_ENTITY_PARSING_ALWAYS</code></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2101	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2102	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2103
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2104	<pre class="fcndec" id="XML_UseForeignDTD">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2105	enum XML_Error XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2106	XML_UseForeignDTD(XML_Parser parser, XML_Bool useDTD);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2107	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2108	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2109	<p>This function allows an application to provide an external subset
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2110	for the document type declaration for documents which do not specify
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2111	an external subset of their own. For documents which specify an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2112	external subset in their DOCTYPE declaration, the application-provided
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2113	subset will be ignored. If the document does not contain a DOCTYPE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2114	declaration at all and <code>useDTD</code> is true, the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2115	application-provided subset will be parsed, but the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2116	<code>startDoctypeDeclHandler</code> and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2117	<code>endDoctypeDeclHandler</code> functions, if set, will not be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2118	called. The setting of parameter entity parsing, controlled using
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2119	<code><a href= "#XML_SetParamEntityParsing"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2120	>XML_SetParamEntityParsing</a></code>, will be honored.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2121
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2122	<p>The application-provided external subset is read by calling the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2123	external entity reference handler set via <code><a href=
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2124	"#XML_SetExternalEntityRefHandler"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2125	>XML_SetExternalEntityRefHandler</a></code> with both
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2126	<code>publicId</code> and <code>systemId</code> set to NULL.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2127
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2128	<p>If this function is called after parsing has begun, it returns
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2129	<code>XML_ERROR_CANT_CHANGE_FEATURE_ONCE_PARSING</code> and ignores
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2130	<code>useDTD</code>. If called when Expat has been compiled without
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2131	DTD support, it returns
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2132	<code>XML_ERROR_FEATURE_REQUIRES_XML_DTD</code>. Otherwise, it
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2133	returns <code>XML_ERROR_NONE</code>.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2134
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2135	<p><b>Note:</b> For the purpose of checking WFC: Entity Declared, passing
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2136	<code>useDTD == XML_TRUE</code> will make the parser behave as if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2137	the document had a DTD with an external subset. This holds true even if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2138	the external entity reference handler returns without action.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2139	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2140
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2141	<pre class="fcndec" id="XML_SetReturnNSTriplet">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2142	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2143	XML_SetReturnNSTriplet(XML_Parser parser,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2144	int do_nst);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2145	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2146	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2147	<p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2148	This function only has an effect when using a parser created with
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2149	<code><a href= "#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2150	i.e. when namespace processing is in effect. The <code>do_nst</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2151	sets whether or not prefixes are returned with names qualified with a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2152	namespace prefix. If this function is called with <code>do_nst</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2153	non-zero, then afterwards namespace qualified names (that is qualified
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2154	with a prefix as opposed to belonging to a default namespace) are
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2155	returned as a triplet with the three parts separated by the namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2156	separator specified when the parser was created. The order of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2157	returned parts is URI, local name, and prefix.</p> <p>If
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2158	<code>do_nst</code> is zero, then namespaces are reported in the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2159	default manner, URI then local_name separated by the namespace
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2160	separator.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2161	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2162
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2163	<pre class="fcndec" id="XML_DefaultCurrent">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2164	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2165	XML_DefaultCurrent(XML_Parser parser);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2166	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2167	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2168	This can be called within a handler for a start element, end element,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2169	processing instruction or character data. It causes the corresponding
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2170	markup to be passed to the default handler set by <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2171	href="#XML_SetDefaultHandler" >XML_SetDefaultHandler</a></code> or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2172	<code><a href="#XML_SetDefaultHandlerExpand"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2173	>XML_SetDefaultHandlerExpand</a></code>. It does nothing if there is
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2174	not a default handler.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2175	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2176
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2177	<pre class="fcndec" id="XML_ExpatVersion">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2178	XML_LChar * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2179	XML_ExpatVersion();
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2180	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2181	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2182	Return the library version as a string (e.g. <code>"expat_1.95.1"</code>).
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2183	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2184
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2185	<pre class="fcndec" id="XML_ExpatVersionInfo">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2186	struct XML_Expat_Version XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2187	XML_ExpatVersionInfo();
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2188	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2189	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2190	typedef struct {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2191	int major;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2192	int minor;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2193	int micro;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2194	} XML_Expat_Version;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2195	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2196	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2197	Return the library version information as a structure.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2198	Some macros are also defined that support compile-time tests of the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2199	library version:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2200	<ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2201	<li><code>XML_MAJOR_VERSION</code></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2202	<li><code>XML_MINOR_VERSION</code></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2203	<li><code>XML_MICRO_VERSION</code></li>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2204	</ul>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2205	Testing these constants is currently the best way to determine if
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2206	particular parts of the Expat API are available.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2207	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2208
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2209	<pre class="fcndec" id="XML_GetFeatureList">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2210	const XML_Feature * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2211	XML_GetFeatureList();
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2212	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2213	<pre class="signature">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2214	enum XML_FeatureEnum {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2215	XML_FEATURE_END = 0,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2216	XML_FEATURE_UNICODE,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2217	XML_FEATURE_UNICODE_WCHAR_T,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2218	XML_FEATURE_DTD,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2219	XML_FEATURE_CONTEXT_BYTES,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2220	XML_FEATURE_MIN_SIZE,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2221	XML_FEATURE_SIZEOF_XML_CHAR,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2222	XML_FEATURE_SIZEOF_XML_LCHAR
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2223	};
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2224
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2225	typedef struct {
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2226	enum XML_FeatureEnum feature;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2227	XML_LChar *name;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2228	long int value;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2229	} XML_Feature;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2230	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2231	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2232	<p>Returns a list of "feature" records, providing details on how
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2233	Expat was configured at compile time. Most applications should not
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2234	need to worry about this, but this information is otherwise not
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2235	available from Expat. This function allows code that does need to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2236	check these features to do so at runtime.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2237
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2238	<p>The return value is an array of <code>XML_Feature</code>,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2239	terminated by a record with a <code>feature</code> of
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2240	<code>XML_FEATURE_END</code> and <code>name</code> of NULL,
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2241	identifying the feature-test macros Expat was compiled with. Since an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2242	application that requires this kind of information needs to determine
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2243	the type of character the <code>name</code> points to, records for the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2244	<code>XML_FEATURE_SIZEOF_XML_CHAR</code> and
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2245	<code>XML_FEATURE_SIZEOF_XML_LCHAR</code> will be located at the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2246	beginning of the list, followed by <code>XML_FEATURE_UNICODE</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2247	and <code>XML_FEATURE_UNICODE_WCHAR_T</code>, if they are present at
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2248	all.</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2249
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2250	<p>Some features have an associated value. If there isn't an
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2251	associated value, the <code>value</code> field is set to 0. At this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2252	time, the following features have been defined to have values:</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2253
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2254	<dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2255	<dt><code>XML_FEATURE_SIZEOF_XML_CHAR</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2256	<dd>The number of bytes occupied by one <code>XML_Char</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2257	character.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2258	<dt><code>XML_FEATURE_SIZEOF_XML_LCHAR</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2259	<dd>The number of bytes occupied by one <code>XML_LChar</code>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2260	character.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2261	<dt><code>XML_FEATURE_CONTEXT_BYTES</code></dt>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2262	<dd>The maximum number of characters of context which can be
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2263	reported by <code><a href= "#XML_GetInputContext"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2264	>XML_GetInputContext</a></code>.</dd>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2265	</dl>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2266	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2267
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2268	<pre class="fcndec" id="XML_FreeContentModel">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2269	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2270	XML_FreeContentModel(XML_Parser parser, XML_Content *model);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2271	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2272	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2273	Function to deallocate the <code>model</code> argument passed to the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2274	<code>XML_ElementDeclHandler</code> callback set using <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2275	href="#XML_SetElementDeclHandler" >XML_ElementDeclHandler</a></code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2276	This function should not be used for any other purpose.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2277	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2278
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2279	<p>The following functions allow external code to share the memory
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2280	allocator an <code>XML_Parser</code> has been configured to use. This
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2281	is especially useful for third-party libraries that interact with a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2282	parser object created by application code, or heavily layered
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2283	applications. This can be essential when using dynamically loaded
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2284	libraries which use different C standard libraries (this can happen on
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2285	Windows, at least).</p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2286
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2287	<pre class="fcndec" id="XML_MemMalloc">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2288	void * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2289	XML_MemMalloc(XML_Parser parser, size_t size);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2290	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2291	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2292	Allocate <code>size</code> bytes of memory using the allocator the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2293	<code>parser</code> object has been configured to use. Returns a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2294	pointer to the memory or NULL on failure. Memory allocated in this
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2295	way must be freed using <code><a href="#XML_MemFree"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2296	>XML_MemFree</a></code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2297	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2298
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2299	<pre class="fcndec" id="XML_MemRealloc">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2300	void * XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2301	XML_MemRealloc(XML_Parser parser, void *ptr, size_t size);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2302	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2303	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2304	Allocate <code>size</code> bytes of memory using the allocator the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2305	<code>parser</code> object has been configured to use.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2306	<code>ptr</code> must point to a block of memory allocated by <code><a
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2307	href="#XML_MemMalloc" >XML_MemMalloc</a></code> or
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2308	<code>XML_MemRealloc</code>, or be NULL. This function tries to
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2309	expand the block pointed to by <code>ptr</code> if possible. Returns
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2310	a pointer to the memory or NULL on failure. On success, the original
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2311	block has either been expanded or freed. On failure, the original
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2312	block has not been freed; the caller is responsible for freeing the
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2313	original block. Memory allocated in this way must be freed using
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2314	<code><a href="#XML_MemFree"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2315	>XML_MemFree</a></code>.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2316	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2317
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2318	<pre class="fcndec" id="XML_MemFree">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2319	void XMLCALL
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2320	XML_MemFree(XML_Parser parser, void *ptr);
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2321	</pre>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2322	<div class="fcndef">
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2323	Free a block of memory pointed to by <code>ptr</code>. The block must
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2324	have been allocated by <code><a href="#XML_MemMalloc"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2325	>XML_MemMalloc</a></code> or <code>XML_MemRealloc</code>, or be NULL.
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2326	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2327
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2328	<hr />
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2329	<p><a href="http://validator.w3.org/check/referer"><img
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2330	src="valid-xhtml10.png" alt="Valid XHTML 1.0!"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2331	height="31" width="88" class="noborder" /></a></p>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2332	</div>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2333	</body>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import martin.trojer@nokia.com parents: diff changeset	2334	</html>

author	Mike Kinghan <mikek@symbian.org>
	Thu, 25 Nov 2010 14:28:39 +0000
branch	GCC_SURGE
changeset 135	10852f1a0ae9
parent 1	2fb8b9db1c86
permissions	-rw-r--r--