NAME

Encode::Detect::Detector - Detects the encoding of data

Back to Top

SYNOPSIS

  use Encode::Detect::Detector;
  my $charset = detect($octets);

  my $d = new Encode::Detect::Detector;
  $d->handle($octets);
  $d->handle($more_octets);
  $d->end;
  my $charset = $d->getresult;

Back to Top

DESCRIPTION

This module provides an interface to Mozilla's universal charset detector, which detects the charset used to encode data.

Back to Top

METHODS

$charset = Encode::Detect::Detector->detect($octets)

Detect the charset used to encode the data in $octets and return the charset's name. Returns undef if the charset cannot be determined with sufficient confidence.

$d = Encode::Detect::Detector->new()

Creates a new Encode::Detect::Detector object and returns it.

$d->handle($octets)

Provides an additional chunk of data to be examined by the detector. May be called multiple times.

Returns zero on success, nonzero if a memory allocation failed.

$d->eof

Informs the detector that there is no more data to be examined. In many cases, this is necessary in order for the detector to make a decision on the charset.

$d->reset

Resets the detector to its initial state.

$d->getresult

Returns the name of the detected charset or undef if no charset has (yet) been decided upon. May be called at any time.

Back to Top

SEE ALSO

the Encode::Detect manpage

Back to Top

AUTHOR

John Gardiner Myers <jgmyers@proofpoint.com>

Back to Top

SUPPORT

For help and thank you notes, e-mail the author directly. To report a bug, submit a patch, or add to the wishlist please visit the CPAN bug manager at: http://rt.cpan.org

Back to Top