home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _bad4deba8a8dbe65d46803e761f19617 < prev    next >
Text File  |  2000-03-23  |  5KB  |  128 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>HTML::Parse - Depreciated</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> HTML::Parse - Depreciated</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  26.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  27.     <LI><A HREF="#author">AUTHOR</A></LI>
  28. </UL>
  29. <!-- INDEX END -->
  30.  
  31. <HR>
  32. <P>
  33. <H1><A NAME="name">NAME</A></H1>
  34. <P>HTML::Parse - Depreciated</P>
  35. <P>
  36. <HR>
  37. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  38. <UL>
  39. <LI>Linux</LI>
  40. <LI>Solaris</LI>
  41. <LI>Windows</LI>
  42. </UL>
  43. <HR>
  44. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  45. <PRE>
  46.  use HTML::Parse;
  47.  $h = parse_htmlfile("test.html");
  48.  print $h->dump;
  49.  $h = parse_html("<p>Some more <i>italic</i> text", $h);
  50.  $h->delete;</PRE>
  51. <PRE>
  52.  print parse_htmlfile("index.html")->as_HTML;  # tidy up markup in a file</PRE>
  53. <P>
  54. <HR>
  55. <H1><A NAME="description">DESCRIPTION</A></H1>
  56. <P><EM>Disclaimer: This module is only provided for backwards compatibility
  57. with earlier versions of this library.  New code shold use the
  58. HTML::Parser and HTML::TreeBuilder modules directly.</EM></P>
  59. <P>The <CODE>HTML::Parse</CODE> module provides functions to parse HTML documents.
  60. There are two functions exported by this module:</P>
  61. <DL>
  62. <DT><STRONG><A NAME="item_parse_html">parse_html($html, [$obj])</A></STRONG><BR>
  63. <DD>
  64. This function is really just a synonym for $obj-><CODE>parse($html)</CODE> and $obj
  65. is assumed to be a subclass of <CODE>HTML::Parser</CODE>.  Refer to
  66. <A HREF="../../../site/lib/HTML/Parser.html">the HTML::Parser manpage</A> for more documentation.
  67. <P>The $obj will default to an internally created <CODE>HTML::TreeBuilder</CODE>
  68. object configured with <CODE>strict_comment()</CODE> turned on.  This class
  69. implements a parser that builds (and is) a HTML syntax tree with
  70. HTML::Element objects as nodes.</P>
  71. <P>The return value from <A HREF="#item_parse_html"><CODE>parse_html()</CODE></A> is $obj.</P>
  72. <P></P>
  73. <DT><STRONG><A NAME="item_parse_htmlfile">parse_htmlfile($file, [$obj])</A></STRONG><BR>
  74. <DD>
  75. Same as parse_html(), but obtains HTML text from the named file.
  76. <P>Returns <A HREF="../../../lib/Pod/perlfunc.html#item_undef"><CODE>undef</CODE></A> if the file could not be opened, or $obj otherwise.</P>
  77. <P></P></DL>
  78. <P>When a <CODE>HTML::TreeBuilder</CODE> object is created, the following variables
  79. control how parsing takes place:</P>
  80. <DL>
  81. <DT><STRONG><A NAME="item_%24HTML%3A%3AParse%3A%3AIMPLICIT_TAGS">$HTML::Parse::IMPLICIT_TAGS</A></STRONG><BR>
  82. <DD>
  83. Setting this variable to true will instruct the parser to try to
  84. deduce implicit elements and implicit end tags.  If this variable is
  85. false you get a parse tree that just reflects the text as it stands.
  86. Might be useful for quick & dirty parsing.  Default is true.
  87. <P>Implicit elements have the <CODE>implicit()</CODE> attribute set.</P>
  88. <P></P>
  89. <DT><STRONG><A NAME="item_%24HTML%3A%3AParse%3A%3AIGNORE_UNKNOWN">$HTML::Parse::IGNORE_UNKNOWN</A></STRONG><BR>
  90. <DD>
  91. This variable contols whether unknow tags should be represented as
  92. elements in the parse tree.  Default is true.
  93. <P></P>
  94. <DT><STRONG><A NAME="item_%24HTML%3A%3AParse%3A%3AIGNORE_TEXT">$HTML::Parse::IGNORE_TEXT</A></STRONG><BR>
  95. <DD>
  96. Do not represent the text content of elements.  This saves space if
  97. all you want is to examine the structure of the document.  Default is
  98. false.
  99. <P></P>
  100. <DT><STRONG><A NAME="item_%24HTML%3A%3AParse%3A%3AWARN">$HTML::Parse::WARN</A></STRONG><BR>
  101. <DD>
  102. Call <A HREF="../../../lib/Pod/perlfunc.html#item_warn"><CODE>warn()</CODE></A> with an apropriate message for syntax errors.  Default is
  103. false.
  104. <P></P></DL>
  105. <P>
  106. <HR>
  107. <H1><A NAME="see also">SEE ALSO</A></H1>
  108. <P><A HREF="../../../site/lib/HTML/Parser.html">the HTML::Parser manpage</A>, <A HREF="../../../site/lib/HTML/TreeBuilder.html">the HTML::TreeBuilder manpage</A>, <A HREF="../../../site/lib/HTML/Element.html">the HTML::Element manpage</A></P>
  109. <P>
  110. <HR>
  111. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  112. <P>Copyright 1995-1998 Gisle Aas. All rights reserved.</P>
  113. <P>This library is free software; you can redistribute it and/or
  114. modify it under the same terms as Perl itself.</P>
  115. <P>
  116. <HR>
  117. <H1><A NAME="author">AUTHOR</A></H1>
  118. <P>Gisle Aas <<A HREF="mailto:aas@sn.no">aas@sn.no</A>></P>
  119. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  120. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  121. <STRONG><P CLASS=block> HTML::Parse - Depreciated</P></STRONG>
  122. </TD></TR>
  123. </TABLE>
  124.  
  125. </BODY>
  126.  
  127. </HTML>
  128.