Badger::Codec::HTML

NAME

Top Close Open

Badger::Codec::HTML - encode and decode reserved characters in HTML

SYNOPSIS

Top Close Open
use Badger::Codec::HTML;

# class methods
my $enc = Badger::Codec::HTML->encode("http://foo.com/bar.html");
my $dec = $codec->decode($enc);

# object methods
my $codec = Badger::Codec::HTML->new();
my $enc   = $codec->encode("http://foo.com/bar.html");
my $dec   = $codec->decode($enc);

DESCRIPTION

Top Close Open

This module implements a subclass of Badger::Codec for encoding and decoding HTML. It is based on code extracted from Lincoln Stein's CGI.pm module.

The encode() method encodes HTML by converting any reserved characters to the correct HTML entities.

The decode() method reverses this process.

METHODS

Top Close Open

encode($html, $charset)

Top Close Open

Encodes the HTML text passed as the first argument.

$encoded = Badger::Codec::HTML->encode($html);

The optional second argument can be used to indicate the character set in use. If this is set to ISO-8859-1 WINDOWS-1252 then the encoded data will undergo some additional processing in order to work around some known bugs in Microsoft's web browsers. See fix_windows().

decode($html)

Top Close Open

Decodes the encoded HTML text passed as the first argument.

$html = Badger::Codec::HTML->decode($encoded);

fix_windows($text)

Top Close Open

This method is used internally to repair the damage caused by bugs in certain inferior browsers.

AUTHOR

Top Close Open

Andy Wardley http://wardley.org/

COPYRIGHT

Top Close Open

Copyright (C) 2005-2009 Andy Wardley. All rights reserved.

ACKNOWLEDGEMENTS

Top Close Open

This code is derived from Lincoln D. Stein's CGI module.

Fork Me on Github