Home | History | Annotate | Download | only in doc

Lines Matching full:expat

10   <title>Expat XML Parser</title>
18 <td class="corner"><img src="expat.png" alt="(Expat logo)" /></td>
19 <td class="banner"><h1>The Expat XML Parser</h1></td>
28 <p>Expat is a library, written in C, for parsing XML documents. It's
30 <code>XML::Parser</code>, Python's <code>xml.parsers.expat</code>, and
41 from <a href="http://www.libexpat.org/">the Expat home page</a>.
46 Clark Cooper to retain copyright and to distribute it with Expat.
57 <li><a href="#using">Using Expat</a></li>
155 <p>Expat is a stream-oriented parser. You register callback (or
163 <p>Expat can be intimidating due to the many kinds of handlers and
232 This is used to ensure that the Expat and the callbacks are using the
233 same calling convention in case the compiler options used for Expat
234 itself and the client code are different. Expat tries not to care
237 For code which uses Expat, however, the calling convention is
241 <p>The <code>XMLCALL</code> annotation was added in Expat 1.95.7, but
242 existing working Expat applications don't need to add it (since they
246 safely with older versions of Expat, you can conditionally define it
247 <em>after</em> including Expat's header file:</p>
250 #include &lt;expat.h&gt;
267 <h2><a name="building">Building and Installing Expat</a></h2>
269 <p>The Expat distribution comes as a compressed (with GNU gzip) tar
271 "http://sourceforge.net/projects/expat/" >Source Forge</a>. After
280 "expat.vcxproj" in the lib directory and build and install in the usual
284 contains the "expat.h" include file and a pre-built DLL.</p>
293 can install Expat with this sequence of commands:</p>
314 <h3>Configuring Expat Using the Pre-Processor</h3>
316 <p>Expat's feature set can be configured using a small number of
318 affect the set of entry points for Expat, only the behavior of the API
328 this, Expat has a smaller memory footprint and can be faster, but will
366 always report NULL. Without this, Expat has a smaller memory
370 <dd>On Windows, this should be set if Expat is going to be linked
382 <h2><a name="using">Using Expat</a></h2>
384 <h3>Compiling and Linking Against Expat</h3>
386 <p>Unless you installed Expat in a location not expected by your
387 compiler and linker, all you have to do to use Expat in your programs
388 is to include the Expat header (<code>#include &lt;expat.h&gt;</code>)
390 needs to link against the Expat library. On Unix systems, this would
392 you'll need to tell the compiler where to look for the Expat header
393 and the linker where to find the Expat library. You may also need to
398 Expat is installed in a standard location:</p>
408 <p>If you installed Expat in, say, <code>/home/me/mystuff</code>, then
426 <h3>Expat Basics</h3>
429 an XML document with Expat is to create a parser object. There are <a
430 href="#creation">three functions</a> in the Expat API for creating a
435 by these functions is an opaque pointer (i.e. "expat.h" declares it as
524 the shared variables. You can then tell Expat (with the <code><a href=
542 reported by a single call to the character data handler. Expat, like
554 <p>Expat is an XML 1.0 parser, and as such never complains based on
595 "#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>, function, Expat
596 performs namespace processing. Under namespace processing, Expat
656 <p>With Expat, you may also specify an encoding at the time of
662 in Expat:</p>
681 <p>Expat places restrictions on character encodings that it can
707 <p>One pitfall that novice Expat users are likely to fall into is that
708 although Expat may accept input in various encodings, the strings that
710 (depending on how Expat was compiled). Your application is responsible
715 <p>Expat does not read or parse external entities directly. Note that
753 <p>Expat 1.95.8 introduces a new feature: its now possible to stop
777 supported with a parsing loop compatible with Expat 1.95.7 or
897 <h2><a name="reference">Expat Reference</a></h2>
928 of an URI. Since Expat does not check namespace URIs for conformance, the
1058 except in this case Expat provides the buffer. By obtaining the
1059 buffer from Expat with the <code><a href= "#XML_GetBuffer"
1071 into. A NULL value is returned if Expat can't allocate enough memory for
1164 <p>New in Expat 1.95.8.</p>
1189 <p>New in Expat 1.95.8.</p>
1216 <p>New in Expat 1.95.8.</p>
1234 <code>XML_Char</code>. This type is conditionally defined in expat.h as
1501 but will not be corrected before Expat 2.0 (at the earliest) to avoid
2188 <code>useDTD</code>. If called when Expat has been compiled without
2264 particular parts of the Expat API are available.
2293 Expat was configured at compile time. Most applications should not
2295 available from Expat. This function allows code that does need to
2301 identifying the feature-test macros Expat was compiled with. Since an