{"id":6810,"date":"2022-12-20T19:33:40","date_gmt":"2022-12-20T22:33:40","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/htmlheadparser-man3\/"},"modified":"2022-12-20T19:33:40","modified_gmt":"2022-12-20T22:33:40","slug":"htmlheadparser-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/htmlheadparser-man3\/","title":{"rendered":"HTML::HeadParser (man3)"},"content":{"rendered":"

HTML::HeadParser<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
METHODS<\/a>
EXAMPLE<\/a>
SEE ALSO<\/a>
COPYRIGHT<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

HTML::HeadParser \u2212 Parse section of a HTML document<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

require HTML::HeadParser;
$p = HTML::HeadParser\u2212>new;
$p\u2212>parse($text) and print “not finished”;
$p\u2212>header(‘Title’) # to access ….<\/title> <br \/> $p\u2212>header(‘Content\u2212Base’) # to access <base href=\"http:\/\/...\"> <br \/> $p\u2212>header(‘Foo’) # to access <meta http\u2212equiv=\"Foo\" content=\"...\"> <br \/> $p\u2212>header(‘X\u2212Meta\u2212Author’) # to access <meta name=\"author\" content=\"...\"> <br \/> $p\u2212>header(‘X\u2212Meta\u2212Charset’) # to access <meta charset=\"...\"><\/p>\n<h2>DESCRIPTION <a name=\"DESCRIPTION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">The “HTML::HeadParser” is a specialized (and lightweight) “HTML::Parser” that will only parse the < <small>HEAD<\/small> >…<\/HEAD> section of an <small>HTML<\/small> document. The <b>parse()<\/b> method will return a <small>FALSE<\/small> value as soon as some < <small>BODY<\/small> > element or body text are found, and should not be called again after this.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">Note that the “HTML::HeadParser” might get confused if raw undecoded <small>UTF\u22128<\/small> is passed to the <b>parse()<\/b> method. Make sure the strings are properly decoded before passing them on.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">The “HTML::HeadParser” keeps a reference to a header object, and the parser will update this header object as the various elements of the < <small>HEAD<\/small> > section of the <small>HTML<\/small> document are recognized. The following header fields are affected: <br \/> Content-Base:<\/p>\n<p style=\"margin-left:17%;\">The <i>Content-Base<\/i> header is initialized from the <base href=\"...\"> element.<\/p>\n<p style=\"margin-left:11%;\">Title:<\/p>\n<p style=\"margin-left:17%;\">The <i>Title<\/i> header is initialized from the <title>…<\/title> element.<\/p>\n<p style=\"margin-left:11%;\">Isindex:<\/p>\n<p style=\"margin-left:17%;\">The <i>Isindex<\/i> header will be added if there is a <isindex> element in the <head>. The header value is initialized from the <i>prompt<\/i> attribute if it is present. If no <i>prompt<\/i> attribute is given it will have \u2019?\u2019 as the value.<\/p>\n<p style=\"margin-left:11%;\">X\u2212Meta-Foo:<\/p>\n<p style=\"margin-left:17%;\">All <meta> elements containing a “name” attribute will result in headers using the prefix “X\u2212Meta\u2212” appended with the value of the “name” attribute as the name of the header, and the value of the “content” attribute as the pushed header value.<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><meta> elements containing a “http\u2212equiv” attribute will result in headers as in above, but without the “X\u2212Meta\u2212” prefix in the header name.<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><meta> elements containing a “charset” attribute will result in an “X\u2212Meta\u2212Charset” header, using the value of the “charset” attribute as the pushed header value.<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\">The \u2019:\u2019 character can\u2019t be represented in header field names, so if the meta element contains this char it\u2019s substituted with \u2019\u2212\u2019 before forming the field name.<\/p>\n<h2>METHODS <a name=\"METHODS\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">The following methods (in addition to those provided by the superclass) are available: <br \/> $hp = HTML::HeadParser\u2212>new <br \/> $hp = HTML::HeadParser\u2212>new( $header )<\/p>\n<p style=\"margin-left:17%;\">The object constructor. The optional $header argument should be a reference to an object that implement the <b>header()<\/b> and <b>push_header()<\/b> methods as defined by the “HTTP::Headers” class. Normally it will be of some class that is a or delegates to the “HTTP::Headers” class.<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\">If no $header is given “HTML::HeadParser” will create an “HTTP::Headers” object by itself (initially empty).<\/p>\n<p style=\"margin-left:11%;\">$hp\u2212>header;<\/p>\n<p style=\"margin-left:17%;\">Returns a reference to the header object.<\/p>\n<p style=\"margin-left:11%;\">$hp\u2212>header( $key )<\/p>\n<p style=\"margin-left:17%;\">Returns a header value. It is just a shorter way to write “$hp\u2212>header\u2212>header($key)”.<\/p>\n<h2>EXAMPLE <a name=\"EXAMPLE\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">$h = HTTP::Headers\u2212>new; <br \/> $p = HTML::HeadParser\u2212>new($h); <br \/> $p\u2212>parse(<<EOT); <br \/> <title>Stupid example<\/title> <br \/> <base href=\"http:\/\/www.linpro.no\/lwp\/\"> <br \/> Normal text starts here. <br \/> EOT <br \/> undef $p; <br \/> print $h\u2212>title; # should print “Stupid example”<\/p>\n<h2>SEE ALSO <a name=\"SEE ALSO\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">HTML::Parser, HTTP::Headers<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">The “HTTP::Headers” class is distributed as part of the <i>libwww-perl<\/i> package. If you don\u2019t have that distribution installed you need to provide the $header argument to the “HTML::HeadParser” constructor with your own object that implements the documented protocol.<\/p>\n<h2>COPYRIGHT <a name=\"COPYRIGHT\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">Copyright 1996\u22122001 Gisle Aas. All rights reserved.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">This library is free software; you can redistribute it and\/or modify it under the same terms as Perl itself.<\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p> HTML::HeadParser \u2212 Parse section of a HTML document <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3177,3007],"class_list":["post-6810","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-htmlheadparser","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6810","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6810"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6810\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6810"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6810"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6810"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}