صفحهٔ اصلی گشت‌و‌گذار راهنما
ورود
jmcaricand
/
libopc
1
0
انشعاب 0
پرونده‌ها مشکلات 0 درخواست واکشی 0 ویکی
درخت: f28b9e0bf0
شاخه‌ها تگ‌ها
libopc
/
third_party
/
libxml2-2.7.7
/
doc
/
interface.html

interface.html 8.0 KB
تاريخچه خام

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859 
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
    2. 

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="SHORTCUT ICON" href="/favicon.ico" /><style type="text/css">
    4. 

  4. TD {font-family: Verdana,Arial,Helvetica}
    5. 

  5. BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
    6. 

  6. H1 {font-family: Verdana,Arial,Helvetica}
    7. 

  7. H2 {font-family: Verdana,Arial,Helvetica}
    8. 

  8. H3 {font-family: Verdana,Arial,Helvetica}
    9. 

  9. A:link, A:visited, A:active { text-decoration: underline }
    10. 

  10. </style><title>The SAX interface</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The SAX interface</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://opencsw.org/packages/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://codespeak.net/lxml/">lxml Python bindings</a></li><li><a href="http://cpan.uwinnipeg.ca/dist/XML-LibXML">Perl bindings</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Sometimes the DOM tree output is just too large to fit reasonably into
    11. 

  11. memory. In that case (and if you don't expect to save back the XML document
    12. 

  12. loaded using libxml), it's better to use the SAX interface of libxml. SAX is
    13. 

  13. a <strong>callback-based interface</strong> to the parser. Before parsing,
    14. 

  14. the application layer registers a customized set of callbacks which are
    15. 

  15. called by the library as it progresses through the XML input.</p><p>To get more detailed step-by-step guidance on using the SAX interface of
    16. 

  16. libxml, see the <a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">nice
    17. 

  17. documentation</a>.written by <a href="mailto:james@daa.com.au">James
    18. 

  18. Henstridge</a>.</p><p>You can debug the SAX behaviour by using the <strong>testSAX</strong>
    19. 

  19. program located in the gnome-xml module (it's usually not shipped in the
    20. 

  20. binary packages of libxml, but you can find it in the tar source
    21. 

  21. distribution). Here is the sequence of callbacks that would be reported by
    22. 

  22. testSAX when parsing the example XML document shown earlier:</p><pre>SAX.setDocumentLocator()
    23. 

  23. SAX.startDocument()
    24. 

  24. SAX.getEntity(amp)
    25. 

  25. SAX.startElement(EXAMPLE, prop1='gnome is great', prop2='&amp;amp; linux too')
    26. 

  26. SAX.characters(   , 3)
    27. 

  27. SAX.startElement(head)
    28. 

  28. SAX.characters(    , 4)
    29. 

  29. SAX.startElement(title)
    30. 

  30. SAX.characters(Welcome to Gnome, 16)
    31. 

  31. SAX.endElement(title)
    32. 

  32. SAX.characters(   , 3)
    33. 

  33. SAX.endElement(head)
    34. 

  34. SAX.characters(   , 3)
    35. 

  35. SAX.startElement(chapter)
    36. 

  36. SAX.characters(    , 4)
    37. 

  37. SAX.startElement(title)
    38. 

  38. SAX.characters(The Linux adventure, 19)
    39. 

  39. SAX.endElement(title)
    40. 

  40. SAX.characters(    , 4)
    41. 

  41. SAX.startElement(p)
    42. 

  42. SAX.characters(bla bla bla ..., 15)
    43. 

  43. SAX.endElement(p)
    44. 

  44. SAX.characters(    , 4)
    45. 

  45. SAX.startElement(image, href='linus.gif')
    46. 

  46. SAX.endElement(image)
    47. 

  47. SAX.characters(    , 4)
    48. 

  48. SAX.startElement(p)
    49. 

  49. SAX.characters(..., 3)
    50. 

  50. SAX.endElement(p)
    51. 

  51. SAX.characters(   , 3)
    52. 

  52. SAX.endElement(chapter)
    53. 

  53. SAX.characters( , 1)
    54. 

  54. SAX.endElement(EXAMPLE)
    55. 

  55. SAX.endDocument()</pre><p>Most of the other interfaces of libxml2 are based on the DOM tree-building
    56. 

  56. facility, so nearly everything up to the end of this document presupposes the
    57. 

  57. use of the standard DOM tree build. Note that the DOM tree itself is built by
    58. 

  58. a set of registered default callbacks, without internal specific
    59. 

  59. interface.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
    60.