HTML::Parse(3pm)

📦
version 5.07 · 11 versions
, in opensuse-leap 16.0

🦋 HTML::Parse — the manual page (yes, that HTML::Parse, bestie)

okay so real talk, the page you're reading is the manpage for HTML::Parse, and it's a whole vibe of its own. Strap in. 💅

✨ NAME ✨

HTML::Parse — Deprecated, a wrapper around HTML::TreeBuilder

(yeah. deprecated. I said what I said, we'll get to it.)

💖 VERSION 💖

This document describes version 5.07 of HTML::Parse, released August 31, 2017 as part of HTML-Tree.

🎀 SYNOPSIS 🎀

  See the documentation for HTML::TreeBuilder

like, that's literally the whole synopsis. iconic behavior honestly.

🌸 DESCRIPTION 🌸

Disclaimer: This module is provided only for backwards compatibility with earlier versions of this library. New code should not use this module, and should really use the HTML::Parser and HTML::TreeBuilder modules directly, instead.

not me being the friend who shows up to the party just so the old group chat doesn't fall apart 😭

The HTML::Parse module provides functions to parse HTML documents. There are two functions exported by this module:

  • parse_html($html) or parse_html($html, $obj) — bestie, this one is really just a synonym for $obj->parse($html), and $obj is assumed to be a subclass of HTML::Parser. Refer to HTML::Parser for more documentation. If $obj is not specified, the $obj will default to an internally created new HTML::TreeBuilder object configured with strict_comment() turned on. That class implements a parser that builds (and is) a HTML syntax tree with HTML::Element objects as nodes. The return value from parse_html() is $obj. 💫
  • parse_htmlfile($file, [$obj]) — Same as parse_html(), but pulls the HTML to parse, from the named file. Returns undef if the file could not be opened, or $obj otherwise. (so if you get undef back, the file said "no thank you" 🙈)

When a HTML::TreeBuilder object is created, the following variables control how parsing takes place:

🧚 the vibe-control variables 🧚

  • $HTML::Parse::IMPLICIT_TAGS — Setting this variable to true will instruct the parser to try to deduce implicit elements and implicit end tags. If this variable is false you get a parse tree that just reflects the text as it stands. Might be useful for quick & dirty parsing. Default is true. Implicit elements have the implicit() attribute set.
  • $HTML::Parse::IGNORE_UNKNOWN — This variable controls whether unknown tags should be represented as elements in the parse tree. Default is true.
  • $HTML::Parse::IGNORE_TEXT — Do not represent the text content of elements. This saves space if all you want is to examine the structure of the document. Default is false.
  • $HTML::Parse::WARN — Call warn() with an appropriate message for syntax errors. Default is false.

🔥 REMEMBER! 🔥

HTML::TreeBuilder objects should be explicitly destroyed when you're finished with them. See HTML::TreeBuilder.

no cap, clean up after yourself. leaving tree builders lying around is NOT main character energy, it's just leaks. 🫶

👑 SEE ALSO 👑

HTML::Parser, HTML::TreeBuilder, HTML::Element

🌈 AUTHOR 🌈

Current maintainers:

  • Christopher J. Madsen <perl AT cjmweb.net>
  • Jeff Fearn <jfearn AT cpan.org>

Original HTML-Tree author:

  • Gisle Aas

Former maintainers:

  • Sean M. Burke
  • Andy Lester
  • Pete Krawczyk <petek AT cpan.org>

You can follow or contribute to HTML-Tree's development at https://github.com/kentfredric/HTML-Tree.

Copyright 1995-1998 Gisle Aas, 1999-2004 Sean M. Burke, 2005 Andy Lester, 2006 Pete Krawczyk, 2010 Jeff Fearn, 2012 Christopher J. Madsen.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The programs in this library are distributed in the hope that they will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

translation: it's free, it's Perl-flavored, and there is no warranty — so don't come for anybody if it acts up. 💀

okay that's the whole page bestie, go forth and parse_html responsibly 🦋✨

sign-off szn: this was perl v5.42.0, dated 2017-09-01, and you've been reading HTML::Parse(3pm). mwah 💜

📦 where this page comes from