---
name: "Encode::Detect::Detector"
section: "3pm"
platform: "linux"
package: "libencode-detect-perl"
version: "1.01-6+b4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Encode::Detect::Detector"
---

# Encode::Detect::Detector(3pm)

Detects the encoding of data

## NAME

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

## 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;
```

## DESCRIPTION

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

## 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.

## SEE ALSO

Encode::Detect

## AUTHOR

John Gardiner Myers \<jgmyers@proofpoint.com\>

## 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*