NAME

HEBCI - HTML Entity Based Codepage Inference

SYNOPSIS

    use Encode::HEBCI;

    $hebci = new Encode::HEBCI();
    @fingerprint_entities = $hebci->supported_entities();
    @possible_encodings = $hebci->fingerprint(%entities_to_values);

DESCRIPTION

The Encode::HEBCI module provides a mechanism to determine the character encoding used to submit an HTML form. It does this by using the encoded values of specially-chosen HTML entities to infer which encodings were possibly used, returning a list to the user.

Full details are available at the HEBCI homepage, http://www.joshisanerd.com/set/.

MODULE

To use the module, simply use it.

    use Encode::HEBCI;

Methods

Encode::HEBCI->`new()`

Returns a new HEBCI object.

Encode::HEBCI->supported_entities();

Returns an array containing the HTML entities that will give the best fingerprint, in order of decreasing utility.

Encode::HEBCI->`fingerprint(%entity_values)`

Returns an array of possible encodings given the values in %entity_values. %entity_values should be a hash with keys of HTML entity names (i.e. without the ampersand or semicolon) to the raw bytes returned to your application by the webbrowser.

Encode::HEBCI->`supported_encodings()`

Returns an array containing the encodings this copy of HEBCI can distinguish between.

Encode::HEBCI->`master_fingerprints()`

Returns the fingerprint table. You probably don't want this.

EXAMPLES

An example CGI is distributed with the source code.

HEBCI - HTML Entity Based Codepage Inference