new

    my $decoder = Email::MIME::RFC2047::Decoder->new();

Creates a new decoder object.

decode_text

    my $string = $decoder->decode_text($encoded_text);

Decodes any MIME header field for which the field body is defined as "unstructured" (RFC 2822) or *text (RFC 822), for example, any Subject or Comments header field.

$encoded_text can also be a reference to a scalar. In this case, the scalar is processed starting from the current search position. See "pos" in perlfunc.

The resulting string is trimmed and any whitespace is collapsed. This means that lines separated by folding whitespace are unfolded. Folding whitespace is not checked for syntactical correctness. Newlines are treated like normal whitespace.

decode_phrase

    my $string = $decoder->decode_phrase($encoded_phrase);

Decodes any "phrase" token (as defined by RFC 2822) in a MIME header field, for example, one that precedes an address in a From, To, or Cc header.

This method works like decode_text but additionally unquotes any "quoted-string"s. It also stops at any special character as defined by RFC 2822, excluding the period character "." and the double quote '"'. If $encoded_phrase is a reference to a scalar, the current search position is set accordingly. This is helpful when parsing RFC 2822 address headers.