.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Mail::Message::Body 3pm" .TH Mail::Message::Body 3pm "2014-08-24" "perl v5.20.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Mail::Message::Body \- the data of a body in a message .SH "INHERITANCE" .IX Header "INHERITANCE" .Vb 3 \& Mail::Message::Body has extra code in \& Mail::Message::Body::Construct \& Mail::Message::Body::Encode \& \& Mail::Message::Body \& is a Mail::Reporter \& \& Mail::Message::Body is extended by \& Mail::Message::Body::File \& Mail::Message::Body::Lines \& Mail::Message::Body::Multipart \& Mail::Message::Body::Nested \& Mail::Message::Body::String \& \& Mail::Message::Body is realized by \& Mail::Message::Body::Delayed .Ve .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 6 \& my Mail::Message $msg = ...; \& my $body = $msg\->body; \& my @text = $body\->lines; \& my $text = $body\->string; \& my $file = $body\->file; # IO::File \& $body\->print(\e*FILE); \& \& my $content_type = $body\->type; \& my $transfer_encoding = $body\->transferEncoding; \& my $encoded = $body\->encode(mime_type => \*(Aqtext/html\*(Aq, \& charset => \*(Aqus\-ascii\*(Aq, transfer_encoding => \*(Aqnone\*(Aq);\en"; \& my $decoded = $body\->decoded; .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" The encoding and decoding functionality of a Mail::Message::Body is implemented in the Mail::Message::Body::Encode package. That package is automatically loaded when encoding and decoding of messages needs to take place. Methods to simply build an process body objects are implemented in Mail::Message::Body::Construct. .PP The body of a message (a Mail::Message object) is stored in one of the many body types. The functionality of each body type is equivalent, but there are performance differences. Each body type has its own documentation with details about its implementation. .PP Extends \*(L"\s-1DESCRIPTION\*(R"\s0 in Mail::Reporter. .SH "OVERLOADED" .IX Header "OVERLOADED" .ie n .IP "overload: \fB""""\fR" 4 .el .IP "overload: \fB``''\fR" 4 .IX Item "overload: """"" (stringification) Returns the body as string \-\-which will trigger completion\*(-- unless called to produce a string for \f(CW\*(C`Carp\*(C'\fR. The latter to avoid deep recursions. .Sp example: stringification of body .Sp .Vb 1 \& print $msg\->body; # implicit by print \& \& my $body = $msg\->body; \& my $x = "$body"; # explicit by interpolation .Ve .IP "overload: \fB'==' and '!='\fR" 4 .IX Item "overload: '==' and '!='" (numeric comparison) compares if two references point to the same message. This only produces correct results is both arguments are message references \fBwithin the same folder\fR. .Sp example: use of numeric comparison on a body .Sp .Vb 5 \& my $skip = $folder\->message(3); \& foreach my $msg (@$folder) \& { next if $msg == $skip; \& $msg\->send; \& } .Ve .IP "overload: \fB@{}\fR" 4 .IX Item "overload: @{}" When a body object is used as being an array reference, the lines of the body are returned. This is the same as using \fIlines()\fR. .Sp example: using a body as array .Sp .Vb 2 \& print $body\->lines\->[1]; # second line \& print $body\->[1]; # same \& \& my @lines = $body\->lines; \& my @lines = @$body; # same .Ve .IP "overload: \fBbool\fR" 4 .IX Item "overload: bool" Always returns a true value, which is needed to have overloaded objects to be used as in \f(CW\*(C`if($body)\*(C'\fR. Otherwise, \f(CW\*(C`if(defined $body)\*(C'\fR would be needed to avoid a runtime error. .SH "METHODS" .IX Header "METHODS" Extends \*(L"\s-1METHODS\*(R"\s0 in Mail::Reporter. .SS "Constructors" .IX Subsection "Constructors" Extends \*(L"Constructors\*(R" in Mail::Reporter. .ie n .IP "$obj\->\fBclone\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBclone\fR()" 4 .IX Item "$obj->clone()" Return a copy of this body, usually to be included in a cloned message. Use \fIMail::Message::clone()\fR for a whole message. .IP "Mail::Message::Body\->\fBnew\fR(%options)" 4 .IX Item "Mail::Message::Body->new(%options)" \&\s-1BE WARNED\s0 that, what you specify here are encodings and such which are already in place. The options will not trigger conversions. When you need conversions, first create a body with options which tell what you've got, and then call \fIencode()\fR for what you need. .Sp .Vb 10 \& \-Option \-\-Defined in \-\-Default \& based_on undef \& charset \*(AqPERL\*(Aq or \& checked \& content_id undef \& data undef \& description undef \& disposition undef \& eol \*(AqNATIVE\*(Aq \& file undef \& log Mail::Reporter \*(AqWARNINGS\*(Aq \& message undef \& mime_type \*(Aqtext/plain\*(Aq \& modified \& trace Mail::Reporter \*(AqWARNINGS\*(Aq \& transfer_encoding \*(Aqnone\*(Aq .Ve .RS 4 .IP "based_on => \s-1BODY\s0" 2 .IX Item "based_on => BODY" The information about encodings must be taken from the specified \s-1BODY,\s0 unless specified differently. .IP "charset => CHARSET|'\s-1PERL\s0'" 2 .IX Item "charset => CHARSET|'PERL'" Defines the character-set which is used in the data. Only useful in combination with a \f(CW\*(C`mime_type\*(C'\fR which refers to \f(CW\*(C`text\*(C'\fR in any shape, which does not contain an explicit charset already. This field is case-insensitive. .Sp When a known \s-1CHARSET\s0 is provided and the mime type says \*(L"text\*(R", then the data is expected to be bytes in that particular encoding (see Encode). When '\s-1PERL\s0' is given, then then the data is in Perl's internal encoding (either latin1 or utf8, you shouldn't know!) More details in \&\*(L"Character encoding \s-1PERL\*(R"\s0 .IP "checked => \s-1BOOLEAN\s0" 2 .IX Item "checked => BOOLEAN" Whether the added information has been check not to contain illegal octets with respect to the transfer encoding and mime type. If not checked, and then set as body for a message, it will be. .IP "content_id => \s-1STRING\s0" 2 .IX Item "content_id => STRING" In multipart/related \s-1MIME\s0 content, the content_id is required to allow access to the related content via a cid:<...> descriptor of an inline disposition. .Sp A \f(CW\*(C`Content\-ID\*(C'\fR is supposed to be globally unique. As such, it is common to append '@computer.domain' to the end of some unique string. As other content in the multipart/related container also needs to know what this \f(CW\*(C`Content\-ID\*(C'\fR is, this should be left to the imagination of the person making the content (for now). .Sp As a \s-1MIME\s0 header field, the \f(CW\*(C`Content\-ID\*(C'\fR string is expected to be inside angle brackets .IP "data => ARRAY-OF-LINES | \s-1STRING\s0" 2 .IX Item "data => ARRAY-OF-LINES | STRING" The content of the body. The only way to set the content of a body is during the creation of the body. So if you want to modify the content of a message, you need to create a new body with the new content and add that to the body. The reason behind this, is that correct encodings and body information must be guaranteed. It avoids your hassle in calculating the number of lines in the body, and checking whether bad characters are enclosed in text. .Sp Specify a reference to an \s-1ARRAY\s0 of lines, each terminated by a newline. Or one \s-1STRING\s0 which may contain multiple lines, separated and terminated by a newline. .IP "description => STRING|FIELD" 2 .IX Item "description => STRING|FIELD" Informal information about the body content. The data relates to the \&\f(CW\*(C`Content\-Description\*(C'\fR field. Specify a \s-1STRING\s0 which will become the field content, or a real \s-1FIELD.\s0 .IP "disposition => STRING|FIELD" 2 .IX Item "disposition => STRING|FIELD" How this message can be decomposed. The data relates to the \&\f(CW\*(C`Content\-Disposition\*(C'\fR field. Specify a \s-1STRING\s0 which will become the field content, or a real \s-1FIELD.\s0 .Sp The content of this field is specified in \s-1RFC 1806. \s0 The body of the field can be \f(CW\*(C`inline\*(C'\fR, to indicate that the body is intended to be displayed automatically upon display of the message. Use \f(CW\*(C`attachment\*(C'\fR to indicate that they are separate from the main body of the mail message, and that their display should not be automatic, but contingent upon some further action of the user. .Sp The \f(CW\*(C`filename\*(C'\fR attribute specifies a name to which is suggested to the reader of the message when it is extracted. .IP "eol => '\s-1CR\s0'|'\s-1LF\s0'|'\s-1CRLF\s0'|'\s-1NATIVE\s0'" 2 .IX Item "eol => 'CR'|'LF'|'CRLF'|'NATIVE'" Convert the message into having the specified string as line terminator for all lines in the body. \f(CW\*(C`NATIVE\*(C'\fR is used to represent the \f(CW\*(C`\en\*(C'\fR on the current platform and will be translated in the applicable one. .Sp \&\s-1BE WARNED\s0 that folders with a non-native encoding may appear on your platform, for instance in Windows folders handled from a \s-1UNIX\s0 system. The eol encoding has effect on the size of the body! .IP "file => FILENAME|FILEHANDLE|IOHANDLE" 2 .IX Item "file => FILENAME|FILEHANDLE|IOHANDLE" Read the data from the specified file, file handle, or object of type \f(CW\*(C`IO::Handle\*(C'\fR. .IP "log => \s-1LEVEL\s0" 2 .IX Item "log => LEVEL" .PD 0 .IP "message => \s-1MESSAGE\s0" 2 .IX Item "message => MESSAGE" .PD The message where this body belongs to. .IP "mime_type => STRING|FIELD|MIME" 2 .IX Item "mime_type => STRING|FIELD|MIME" The type of data which is added. You may specify a content of a header line as \s-1STRING,\s0 or a \s-1FIELD\s0 object. You may also specify a MIME::Type object. In any case, it will be kept internally as a real field (a Mail::Message::Field object). This relates to the \&\f(CW\*(C`Content\-Type\*(C'\fR header field. .Sp A mime-type specification consists of two parts: a general class (\f(CW\*(C`text\*(C'\fR, \&\f(CW\*(C`image\*(C'\fR, \f(CW\*(C`application\*(C'\fR, etc) and a specific sub-class. Examples for specific classes with \f(CW\*(C`text\*(C'\fR are \f(CW\*(C`plain\*(C'\fR, \f(CW\*(C`html\*(C'\fR, and \f(CW\*(C`xml\*(C'\fR. This field is case-insensitive but case preserving. The default mime-type is \f(CW\*(C`text/plain\*(C'\fR, .IP "modified => \s-1BOOLEAN\s0" 2 .IX Item "modified => BOOLEAN" Whether the body is flagged modified, directly from its creation. .IP "trace => \s-1LEVEL\s0" 2 .IX Item "trace => LEVEL" .PD 0 .IP "transfer_encoding => STRING|FIELD" 2 .IX Item "transfer_encoding => STRING|FIELD" .PD The encoding that the data has. If the data is to be encoded, than you will have to call \fIencode()\fR after the body is created. That will return a new encoded body. This field is case-insensitive and relates to the \f(CW\*(C`Content\-Transfer\-Encoding\*(C'\fR field in the header. .RE .RS 4 .Sp example: .Sp .Vb 2 \& my $body = Mail::Message::Body::String\->new(file => \e*IN, \& mime_type => \*(Aqtext/html; charset="ISO\-8859\-1"\*(Aq); \& \& my $body = Mail::Message::Body::Lines\->new(data => [\*(Aqfirst\*(Aq, $second], \& charset => \*(AqISO\-10646\*(Aq, transfer_encoding => \*(Aqnone\*(Aq); \& \& my $body = Mail::Message::Body::Lines\->new(data => \e@lines, \& transfer_encoding => \*(Aqbase64\*(Aq); \& \& my $body = Mail::Message::Body::Lines\->new(file => \*(Aqpicture.gif\*(Aq, \& mime_type => \*(Aqimage/gif\*(Aq, content_id => \*(Aq<12345@example.com>\*(Aq, \& disposition => \*(Aqinline\*(Aq); .Ve .RE .SS "Constructing a body" .IX Subsection "Constructing a body" .ie n .IP "$obj\->\fBattach\fR($messages, %options)" 4 .el .IP "\f(CW$obj\fR\->\fBattach\fR($messages, \f(CW%options\fR)" 4 .IX Item "$obj->attach($messages, %options)" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Construct .ie n .IP "$obj\->\fBcheck\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBcheck\fR()" 4 .IX Item "$obj->check()" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBconcatenate\fR($components)" 4 .el .IP "\f(CW$obj\fR\->\fBconcatenate\fR($components)" 4 .IX Item "$obj->concatenate($components)" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Construct .ie n .IP "$obj\->\fBdecoded\fR(%options)" 4 .el .IP "\f(CW$obj\fR\->\fBdecoded\fR(%options)" 4 .IX Item "$obj->decoded(%options)" Returns a body, an object which is (a sub\-)class of a Mail::Message::Body, which contains a simplified representation of textual data. The returned object may be the object where this is called on, but may also be a new body of any type. .Sp .Vb 1 \& my $dec = $body\->decoded; .Ve .Sp is equivalent with .Sp .Vb 5 \& my $dec = $body\->encode \& ( mime_type => \*(Aqtext/plain\*(Aq \& , transfer_encoding => \*(Aqnone\*(Aq \& , charset => \*(AqPERL\*(Aq \& ); .Ve .Sp The \f(CW$dec\fR which is returned is a body. Ask with the \fImimeType()\fR method what is produced. This \f(CW$dec\fR body is \fBnot related to a header\fR. .Sp .Vb 2 \& \-Option \-\-Default \& result_type .Ve .RS 4 .IP "result_type => \s-1CLASS\s0" 2 .IX Item "result_type => CLASS" .RE .RS 4 .RE .PD 0 .ie n .IP "$obj\->\fBencode\fR(%options)" 4 .el .IP "\f(CW$obj\fR\->\fBencode\fR(%options)" 4 .IX Item "$obj->encode(%options)" .PD Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBencoded\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBencoded\fR()" 4 .IX Item "$obj->encoded()" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBeol\fR( ['\s-1CR\s0'|'\s-1LF\s0'|'\s-1CRLF\s0'|'\s-1NATIVE\s0'] )" 4 .el .IP "\f(CW$obj\fR\->\fBeol\fR( ['\s-1CR\s0'|'\s-1LF\s0'|'\s-1CRLF\s0'|'\s-1NATIVE\s0'] )" 4 .IX Item "$obj->eol( ['CR'|'LF'|'CRLF'|'NATIVE'] )" Returns the character (or characters) which are used to separate lines within this body. When a kind of separator is specified, the body is translated to contain the specified line endings. .Sp example: .Sp .Vb 2 \& my $body = $msg\->decoded\->eol(\*(AqNATIVE\*(Aq); \& my $char = $msg\->decoded\->eol; .Ve .ie n .IP "$obj\->\fBforeachLine\fR(\s-1CODE\s0)" 4 .el .IP "\f(CW$obj\fR\->\fBforeachLine\fR(\s-1CODE\s0)" 4 .IX Item "$obj->foreachLine(CODE)" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Construct .ie n .IP "$obj\->\fBstripSignature\fR(%options)" 4 .el .IP "\f(CW$obj\fR\->\fBstripSignature\fR(%options)" 4 .IX Item "$obj->stripSignature(%options)" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Construct .ie n .IP "$obj\->\fBunify\fR($body)" 4 .el .IP "\f(CW$obj\fR\->\fBunify\fR($body)" 4 .IX Item "$obj->unify($body)" Inherited, see \*(L"Constructing a body\*(R" in Mail::Message::Body::Encode .SS "The body" .IX Subsection "The body" .ie n .IP "$obj\->\fBisDelayed\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBisDelayed\fR()" 4 .IX Item "$obj->isDelayed()" Returns a true or false value, depending on whether the body of this message has been read from file. This can only false for a Mail::Message::Body::Delayed. .ie n .IP "$obj\->\fBisMultipart\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBisMultipart\fR()" 4 .IX Item "$obj->isMultipart()" Returns whether this message-body contains parts which are messages by themselves. .ie n .IP "$obj\->\fBisNested\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBisNested\fR()" 4 .IX Item "$obj->isNested()" Only true for a message body which contains exactly one sub-message: the \f(CW\*(C`Mail::Message::Body::Nested\*(C'\fR body type. .ie n .IP "$obj\->\fBmessage\fR( [$message] )" 4 .el .IP "\f(CW$obj\fR\->\fBmessage\fR( [$message] )" 4 .IX Item "$obj->message( [$message] )" Returns the message (or message part) where this body belongs to, optionally setting it to a new \f(CW$message\fR first. If \f(CW\*(C`undef\*(C'\fR is passed, the body will be disconnected from the message. .ie n .IP "$obj\->\fBpartNumberOf\fR($part)" 4 .el .IP "\f(CW$obj\fR\->\fBpartNumberOf\fR($part)" 4 .IX Item "$obj->partNumberOf($part)" Returns a string for multiparts and nested, otherwise an error. It is used in \fIMail::Message::partNumber()\fR. .SS "About the payload" .IX Subsection "About the payload" .ie n .IP "$obj\->\fBcharset\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBcharset\fR()" 4 .IX Item "$obj->charset()" Returns the character set which is used in the text body as string. This is part of the result of what the \f(CW\*(C`type\*(C'\fR method returns. .ie n .IP "$obj\->\fBchecked\fR( [\s-1BOOLEAN\s0] )" 4 .el .IP "\f(CW$obj\fR\->\fBchecked\fR( [\s-1BOOLEAN\s0] )" 4 .IX Item "$obj->checked( [BOOLEAN] )" Returns whether the body encoding has been checked or not (optionally after setting the flag to a new value). .ie n .IP "$obj\->\fBcontentId\fR( [STRING|$field] )" 4 .el .IP "\f(CW$obj\fR\->\fBcontentId\fR( [STRING|$field] )" 4 .IX Item "$obj->contentId( [STRING|$field] )" Returns (optionally after setting) the id (unique reference) of a message part. The related header field is \f(CW\*(C`Content\-ID\*(C'\fR. A Mail::Message::Field object is returned (which stringifies into the field content). The field content will be \f(CW\*(C`none\*(C'\fR if no disposition was specified. .Sp The argument can be a \s-1STRING \s0(which is converted into a field), or a fully prepared header \f(CW$field\fR. .ie n .IP "$obj\->\fBdescription\fR( [STRING|$field] )" 4 .el .IP "\f(CW$obj\fR\->\fBdescription\fR( [STRING|$field] )" 4 .IX Item "$obj->description( [STRING|$field] )" Returns (optionally after setting) the informal description of the body content. The related header field is \f(CW\*(C`Content\-Description\*(C'\fR. A Mail::Message::Field object is returned (which stringifies into the field content). The field content will be \f(CW\*(C`none\*(C'\fR if no disposition was specified. .Sp The argument can be a \s-1STRING \s0(which is converted into a field), or a fully prepared header field. .ie n .IP "$obj\->\fBdisposition\fR( [STRING|$field] )" 4 .el .IP "\f(CW$obj\fR\->\fBdisposition\fR( [STRING|$field] )" 4 .IX Item "$obj->disposition( [STRING|$field] )" Returns (optionally after setting) how the message can be disposed (unpacked). The related header field is \f(CW\*(C`Content\-Disposition\*(C'\fR. A Mail::Message::Field object is returned (which stringifies into the field content). The field content will be \f(CW\*(C`none\*(C'\fR if no disposition was specified. .Sp The argument can be a \s-1STRING \s0(which is converted into a field), or a fully prepared header field. .ie n .IP "$obj\->\fBdispositionFilename\fR( [$directory] )" 4 .el .IP "\f(CW$obj\fR\->\fBdispositionFilename\fR( [$directory] )" 4 .IX Item "$obj->dispositionFilename( [$directory] )" Inherited, see \*(L"About the payload\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBisBinary\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBisBinary\fR()" 4 .IX Item "$obj->isBinary()" Inherited, see \*(L"About the payload\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBisText\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBisText\fR()" 4 .IX Item "$obj->isText()" Inherited, see \*(L"About the payload\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBmimeType\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBmimeType\fR()" 4 .IX Item "$obj->mimeType()" Returns a MIME::Type object which is related to this body's type. This differs from the \f(CW\*(C`type\*(C'\fR method, which results in a Mail::Message::Field. .Sp example: .Sp .Vb 2 \& if($body\->mimeType eq \*(Aqtext/html\*(Aq) {...} \& print $body\->mimeType\->simplified; .Ve .ie n .IP "$obj\->\fBnrLines\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBnrLines\fR()" 4 .IX Item "$obj->nrLines()" Returns the number of lines in the message body. For multi-part messages, this includes the header lines and boundaries of all the parts. .ie n .IP "$obj\->\fBsize\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBsize\fR()" 4 .IX Item "$obj->size()" The total number of bytes in the message body. The size of the body is computed in the shape it is in. For example, if this is a base64 encoded message, the size of the encoded data is returned; you may want to call \fIMail::Message::decoded()\fR first. .ie n .IP "$obj\->\fBtransferEncoding\fR( [STRING|$field] )" 4 .el .IP "\f(CW$obj\fR\->\fBtransferEncoding\fR( [STRING|$field] )" 4 .IX Item "$obj->transferEncoding( [STRING|$field] )" Returns the transfer-encoding of the data within this body as Mail::Message::Field (which stringifies to its content). If it needs to be changed, call the \fIencode()\fR or \fIdecoded()\fR method. When no encoding is present, the field contains the text \f(CW\*(C`none\*(C'\fR. .Sp The optional \s-1STRING\s0 or \f(CW$field\fR enforces a new encoding to be set, without the actual required translations. .Sp example: .Sp .Vb 3 \& my $transfer = $msg\->decoded\->transferEncoding; \& $transfer\->print; # \-\-> Content\-Encoding: base64 \& print $transfer; # \-\-> base64 \& \& if($msg\->body\->transferEncoding eq \*(Aqnone\*(Aq) {...} .Ve .ie n .IP "$obj\->\fBtype\fR( [STRING|$field] )" 4 .el .IP "\f(CW$obj\fR\->\fBtype\fR( [STRING|$field] )" 4 .IX Item "$obj->type( [STRING|$field] )" Returns the type of information the body contains as Mail::Message::Field object. The type is taken from the header field \f(CW\*(C`Content\-Type\*(C'\fR. If the header did not contain that field, then you will get a default field containing \f(CW\*(C`text/plain\*(C'\fR. .Sp You usually can better use \fImimeType()\fR, because that will return a clever object with type information. .Sp example: .Sp .Vb 3 \& my $msg = $folder\->message(6); \& $msg\->get(\*(AqContent\-Type\*(Aq)\->print; \& # \-\-> Content\-Type: text/plain; charset="us\-ascii" \& \& my $content = $msg\->decoded; \& my $type = $content\->type; \& \& print "This is a $type message\en"; \& # \-\-> This is a text/plain; charset="us\-ascii" message \& \& print "This is a ", $type\->body, "message\en"; \& # \-\-> This is a text/plain message \& \& print "Comment: ", $type\->comment, "\en"; \& # \-\-> Comment: charset="us\-ascii" .Ve .SS "Access to the payload" .IX Subsection "Access to the payload" .ie n .IP "$obj\->\fBendsOnNewline\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBendsOnNewline\fR()" 4 .IX Item "$obj->endsOnNewline()" Returns whether the last line of the body is terminated by a new-line (in transport it will become a \s-1CRLF\s0). An empty body will return true as well: the newline comes from the line before it. .ie n .IP "$obj\->\fBfile\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBfile\fR()" 4 .IX Item "$obj->file()" Return the content of the body as a file handle. The returned stream may be a real file, or a simulated file in any form that Perl supports. While you may not be able to write to the file handle, you can read from it. .Sp \&\s-1WARNING:\s0 Even if the file handle supports writing, do not write to the file handle. If you do, some of the internal values of the Mail::Message::Body may not be updated. .ie n .IP "$obj\->\fBlines\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBlines\fR()" 4 .IX Item "$obj->lines()" Return the content of the body as a list of lines (in \s-1LIST\s0 context) or a reference to an array of lines (in \s-1SCALAR\s0 context). In scalar context the array of lines is cached to avoid needless copying and therefore provide much faster access for large messages. .Sp To just get the number of lines in the body, use the \fInrLines()\fR method, which is usually much more efficient. .Sp \&\s-1BE WARNED:\s0 For some types of bodies the reference will refer to the original data. You must not change the referenced data! If you do, some of the essential internal variables of the Mail::Message::Body may not be updated. .Sp example: .Sp .Vb 3 \& my @lines = $body\->lines; # copies lines \& my $line3 = ($body\->lines)[3] # only one copy \& print $lines[0]; \& \& my $linesref = $body\->lines; # reference to originals \& my $line3 = $body\->lines\->[3] # only one copy (faster) \& print $linesref\->[0]; \& \& print $body\->[0]; # by overloading .Ve .ie n .IP "$obj\->\fBprint\fR( [$fh] )" 4 .el .IP "\f(CW$obj\fR\->\fBprint\fR( [$fh] )" 4 .IX Item "$obj->print( [$fh] )" Print the body to the specified \f(CW$fh\fR (defaults to the selected handle). The handle may be a \s-1GLOB,\s0 an IO::File object, or... any object with a \&\f(CW\*(C`print()\*(C'\fR method will do. Nothing useful is returned. .ie n .IP "$obj\->\fBprintEscapedFrom\fR($fh)" 4 .el .IP "\f(CW$obj\fR\->\fBprintEscapedFrom\fR($fh)" 4 .IX Item "$obj->printEscapedFrom($fh)" Print the body to the specified \f(CW$fh\fR but all lines which start with 'From ' (optionally already preceded by >'s) will habe an > added in front. Nothing useful is returned. .ie n .IP "$obj\->\fBstring\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBstring\fR()" 4 .IX Item "$obj->string()" Return the content of the body as a scalar (a single string). This is a copy of the internally kept information. .Sp example: .Sp .Vb 2 \& my $text = $body\->string; \& print "Body: $body\en"; # by overloading .Ve .ie n .IP "$obj\->\fBstripTrailingNewline\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBstripTrailingNewline\fR()" 4 .IX Item "$obj->stripTrailingNewline()" Remove the newline from the last line, or the last line if it does not contain anything else than a newline. .ie n .IP "$obj\->\fBwrite\fR(%options)" 4 .el .IP "\f(CW$obj\fR\->\fBwrite\fR(%options)" 4 .IX Item "$obj->write(%options)" Write the content of the body to a file. Be warned that you may want to decode the body before writing it! .Sp .Vb 2 \& \-Option \-\-Default \& filename .Ve .RS 4 .IP "filename => \s-1FILENAME\s0" 2 .IX Item "filename => FILENAME" .RE .RS 4 .Sp example: write the data to a file .Sp .Vb 4 \& use File::Temp; \& my $fn = tempfile; \& $message\->decoded\->write(filename => $fn) \& or die "Couldn\*(Aqt write to $fn: $!\en"; .Ve .Sp example: using the content-disposition information to write .Sp .Vb 5 \& use File::Temp; \& my $dir = tempdir; mkdir $dir or die; \& my $fn = $message\->body\->dispositionFilename($dir); \& $message\->decoded\->write(filename => $fn) \& or die "Couldn\*(Aqt write to $fn: $!\en"; .Ve .RE .SS "Internals" .IX Subsection "Internals" .ie n .IP "$obj\->\fBaddTransferEncHandler\fR( $name, <$class|$object> )" 4 .el .IP "\f(CW$obj\fR\->\fBaddTransferEncHandler\fR( \f(CW$name\fR, <$class|$object> )" 4 .IX Item "$obj->addTransferEncHandler( $name, <$class|$object> )" .PD 0 .ie n .IP "Mail::Message::Body\->\fBaddTransferEncHandler\fR( $name, <$class|$object> )" 4 .el .IP "Mail::Message::Body\->\fBaddTransferEncHandler\fR( \f(CW$name\fR, <$class|$object> )" 4 .IX Item "Mail::Message::Body->addTransferEncHandler( $name, <$class|$object> )" .PD Inherited, see \*(L"Internals\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBcontentInfoFrom\fR($head)" 4 .el .IP "\f(CW$obj\fR\->\fBcontentInfoFrom\fR($head)" 4 .IX Item "$obj->contentInfoFrom($head)" Transfer the body related info from the header into this body. .ie n .IP "$obj\->\fBcontentInfoTo\fR($head)" 4 .el .IP "\f(CW$obj\fR\->\fBcontentInfoTo\fR($head)" 4 .IX Item "$obj->contentInfoTo($head)" Copy the content information (the \f(CW\*(C`Content\-*\*(C'\fR fields) into the specified \&\f(CW$head\fR. The body was created from raw data without the required information, which must be added. See also \fIcontentInfoFrom()\fR. .ie n .IP "$obj\->\fBfileLocation\fR( [$begin, $end] )" 4 .el .IP "\f(CW$obj\fR\->\fBfileLocation\fR( [$begin, \f(CW$end\fR] )" 4 .IX Item "$obj->fileLocation( [$begin, $end] )" The location of the body in the file. Returned a list containing begin and end. The begin is the offsets of the first byte if the folder used for this body. The end is the offset of the first byte of the next message. .ie n .IP "$obj\->\fBgetTransferEncHandler\fR($type)" 4 .el .IP "\f(CW$obj\fR\->\fBgetTransferEncHandler\fR($type)" 4 .IX Item "$obj->getTransferEncHandler($type)" Inherited, see \*(L"Internals\*(R" in Mail::Message::Body::Encode .ie n .IP "$obj\->\fBisModified\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBisModified\fR()" 4 .IX Item "$obj->isModified()" Returns whether the body has changed. .ie n .IP "$obj\->\fBload\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBload\fR()" 4 .IX Item "$obj->load()" Be sure that the body is loaded. This returns the loaded body. .ie n .IP "$obj\->\fBmodified\fR( [\s-1BOOLEAN\s0] )" 4 .el .IP "\f(CW$obj\fR\->\fBmodified\fR( [\s-1BOOLEAN\s0] )" 4 .IX Item "$obj->modified( [BOOLEAN] )" Change the body modification flag. This will force a re-write of the body to a folder file when it is closed. It is quite dangerous to change the body: the same body may be shared between messages within your program. .Sp Especially be warned that you have to change the message-id when you change the body of the message: no two messages should have the same id. .Sp Without value, the current setting is returned, although you can better use \&\fIisModified()\fR. .ie n .IP "$obj\->\fBmoveLocation\fR( [$distance] )" 4 .el .IP "\f(CW$obj\fR\->\fBmoveLocation\fR( [$distance] )" 4 .IX Item "$obj->moveLocation( [$distance] )" Move the registration of the message to a new location over \f(CW$distance\fR. This is called when the message is written to a new version of the same folder-file. .ie n .IP "$obj\->\fBread\fR( $parser, $head, $bodytype, [$chars, [$lines]] )" 4 .el .IP "\f(CW$obj\fR\->\fBread\fR( \f(CW$parser\fR, \f(CW$head\fR, \f(CW$bodytype\fR, [$chars, [$lines]] )" 4 .IX Item "$obj->read( $parser, $head, $bodytype, [$chars, [$lines]] )" Read the body with the \f(CW$parser\fR from file. The implementation of this method will differ between types of bodies. The \f(CW$bodytype\fR argument is a class name or a code reference of a routine which can produce a class name, and is used in multipart bodies to determine the type of the body for each part. .Sp The \f(CW$chars\fR argument is the estimated number of bytes in the body, or \&\f(CW\*(C`undef\*(C'\fR when this is not known. This data can sometimes be derived from the header (the \f(CW\*(C`Content\-Length\*(C'\fR line) or file-size. .Sp The second argument is the estimated number of \f(CW$lines\fR of the body. It is less useful than the \f(CW$chars\fR but may be of help determining whether the message separator is trustworthy. This value may be found in the \f(CW\*(C`Lines\*(C'\fR field of the header. .SS "Error handling" .IX Subsection "Error handling" Extends \*(L"Error handling\*(R" in Mail::Reporter. .ie n .IP "$obj\->\fB\s-1AUTOLOAD\s0\fR()" 4 .el .IP "\f(CW$obj\fR\->\fB\s-1AUTOLOAD\s0\fR()" 4 .IX Item "$obj->AUTOLOAD()" When an unknown method is called on a message body object, this may not be problematic. For performance reasons, some methods are implemented in separate files, and only demand-loaded. If this delayed compilation of additional modules does not help, an error will be produced. .ie n .IP "$obj\->\fBaddReport\fR($object)" 4 .el .IP "\f(CW$obj\fR\->\fBaddReport\fR($object)" 4 .IX Item "$obj->addReport($object)" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBdefaultTrace\fR( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )" 4 .el .IP "\f(CW$obj\fR\->\fBdefaultTrace\fR( [$level]|[$loglevel, \f(CW$tracelevel\fR]|[$level, \f(CW$callback\fR] )" 4 .IX Item "$obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )" .PD 0 .ie n .IP "Mail::Message::Body\->\fBdefaultTrace\fR( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )" 4 .el .IP "Mail::Message::Body\->\fBdefaultTrace\fR( [$level]|[$loglevel, \f(CW$tracelevel\fR]|[$level, \f(CW$callback\fR] )" 4 .IX Item "Mail::Message::Body->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )" .PD Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBerrors\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBerrors\fR()" 4 .IX Item "$obj->errors()" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBlog\fR( [$level, [$strings]] )" 4 .el .IP "\f(CW$obj\fR\->\fBlog\fR( [$level, [$strings]] )" 4 .IX Item "$obj->log( [$level, [$strings]] )" .PD 0 .IP "Mail::Message::Body\->\fBlog\fR( [$level, [$strings]] )" 4 .IX Item "Mail::Message::Body->log( [$level, [$strings]] )" .PD Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBlogPriority\fR($level)" 4 .el .IP "\f(CW$obj\fR\->\fBlogPriority\fR($level)" 4 .IX Item "$obj->logPriority($level)" .PD 0 .IP "Mail::Message::Body\->\fBlogPriority\fR($level)" 4 .IX Item "Mail::Message::Body->logPriority($level)" .PD Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBlogSettings\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBlogSettings\fR()" 4 .IX Item "$obj->logSettings()" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBnotImplemented\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBnotImplemented\fR()" 4 .IX Item "$obj->notImplemented()" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBreport\fR( [$level] )" 4 .el .IP "\f(CW$obj\fR\->\fBreport\fR( [$level] )" 4 .IX Item "$obj->report( [$level] )" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBreportAll\fR( [$level] )" 4 .el .IP "\f(CW$obj\fR\->\fBreportAll\fR( [$level] )" 4 .IX Item "$obj->reportAll( [$level] )" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBtrace\fR( [$level] )" 4 .el .IP "\f(CW$obj\fR\->\fBtrace\fR( [$level] )" 4 .IX Item "$obj->trace( [$level] )" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .ie n .IP "$obj\->\fBwarnings\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBwarnings\fR()" 4 .IX Item "$obj->warnings()" Inherited, see \*(L"Error handling\*(R" in Mail::Reporter .SS "Cleanup" .IX Subsection "Cleanup" Extends \*(L"Cleanup\*(R" in Mail::Reporter. .ie n .IP "$obj\->\fB\s-1DESTROY\s0\fR()" 4 .el .IP "\f(CW$obj\fR\->\fB\s-1DESTROY\s0\fR()" 4 .IX Item "$obj->DESTROY()" Inherited, see \*(L"Cleanup\*(R" in Mail::Reporter .SH "DETAILS" .IX Header "DETAILS" .SS "Access to the body" .IX Subsection "Access to the body" A body can be contained in a message, but may also live without a message. In both cases it stores data, and the same questions can be asked: what type of data it is, how many bytes and lines, what encoding is used. Any body can be encoded and decoded, returning a new body object. However, bodies which are part of a message will always be in a shape that they can be written to a file or send to somewhere: they will be encoded if needed. .SS "Body class implementation" .IX Subsection "Body class implementation" The body of a message can be stored in many ways. Roughly, the implementations can be split in two groups: the data collectors and the complex bodies. The primer implement various ways to access data, and are full compatible: they only differ in performance and memory footprint under different circumstances. The latter are created to handle complex multiparts and lazy extraction. .PP \fIData collector bodies\fR .IX Subsection "Data collector bodies" .IP "\(bu" 4 Mail::Message::Body::String .Sp The whole message body is stored in one scalar. Small messages can be contained this way without performance penalties. .IP "\(bu" 4 Mail::Message::Body::Lines .Sp Each line of the message body is stored as single scalar. This is a useful representation for a detailed look in the message body, which is usually line-organized. .IP "\(bu" 4 Mail::Message::Body::File .Sp The message body is stored in an external temporary file. This type of storage is especially useful when the body is large, the total folder is large, or memory is limited. .IP "\(bu" 4 Mail::Message::Body::InFolder .Sp \&\s-1NOT IMPLEMENTED YET.\s0 The message is kept in the folder, and is only taken out when the content is changed. .IP "\(bu" 4 Mail::Message::Body::External .Sp \&\s-1NOT IMPLEMENTED YET.\s0 The message is kept in a separate file, usually because the message body is large. The difference with the \f(CW\*(C`::External\*(C'\fR object is that this external storage stays this way between closing and opening of a folder. The \&\f(CW\*(C`::External\*(C'\fR object only uses a file when the folder is open. .PP \fIComplex bodies\fR .IX Subsection "Complex bodies" .IP "\(bu" 4 Mail::Message::Body::Delayed .Sp The message-body is not yet read, but the exact location of the body is known so the message can be read when needed. This is part of the lazy extraction mechanism. Once extracted, the object can become any simple or complex body. .IP "\(bu" 4 Mail::Message::Body::Multipart .Sp The message body contains a set of sub-messages (which can contain multipart bodies themselves). Each sub-message is an instance of Mail::Message::Part, which is an extension of Mail::Message. .IP "\(bu" 4 Mail::Message::Body::Nested .Sp Nested messages, like \f(CW\*(C`message/rfc822\*(C'\fR: they contain a message in the body. For most code, they simply behave like multiparts. .SS "Character encoding \s-1PERL\s0" .IX Subsection "Character encoding PERL" A body object can be part of a message, or stand-alone. In case it is a part of a message, the \*(L"transport encoding\*(R" and the content must be in a shape that the data can be transported via \s-1SMTP.\s0 .PP However, when you want to process the body data in simple Perl (or when you construct the body data from normal Perl strings), you need to be aware of Perl's internal representation of strings. That can either be latin1 or utf8 (not real \s-1UTF\-8,\s0 but something alike, see the perlunicode manual page) So, before you start using the data from an incoming message, do .PP .Vb 2 \& my $body = $msg\->decoded; \& my @lines = $body\->lines; .Ve .PP Now, the body has character-set '\s-1PERL\s0' (when it is text) .PP When you create a new body which contains text content (the default), it will be created with character-set '\s-1PERL\s0' unless you specify a character-set explicitly. .PP .Vb 2 \& my $body = Mail::Box::Body::Lines\->new(data => \e@lines); \& # now mime=text/plain, charset=PERL \& \& my $msg = Mail::Message\->buildFromBody($body); \& $msg\->body($body); \& $msg\->attach($body); # etc \& # these all will convert the charset=PERL into real utf\-8 .Ve .SH "DIAGNOSTICS" .IX Header "DIAGNOSTICS" .ie n .IP "Warning: Charset $name is not known" 4 .el .IP "Warning: Charset \f(CW$name\fR is not known" 4 .IX Item "Warning: Charset $name is not known" The encoding or decoding of a message body encounters a character set which is not understood by Perl's Encode module. .ie n .IP "Warning: No decoder defined for transfer encoding $name." 4 .el .IP "Warning: No decoder defined for transfer encoding \f(CW$name\fR." 4 .IX Item "Warning: No decoder defined for transfer encoding $name." The data (message body) is encoded in a way which is not currently understood, therefore no decoding (or recoding) can take place. .ie n .IP "Warning: No encoder defined for transfer encoding $name." 4 .el .IP "Warning: No encoder defined for transfer encoding \f(CW$name\fR." 4 .IX Item "Warning: No encoder defined for transfer encoding $name." The data (message body) has been decoded, but the required encoding is unknown. The decoded data is returned. .ie n .IP "Error: Package $package does not implement $method." 4 .el .IP "Error: Package \f(CW$package\fR does not implement \f(CW$method\fR." 4 .IX Item "Error: Package $package does not implement $method." Fatal error: the specific package (or one of its superclasses) does not implement this method where it should. This message means that some other related classes do implement this method however the class at hand does not. Probably you should investigate this and probably inform the author of the package. .ie n .IP "Warning: Unknown line terminator $eol ignored" 4 .el .IP "Warning: Unknown line terminator \f(CW$eol\fR ignored" 4 .IX Item "Warning: Unknown line terminator $eol ignored" .SH "SEE ALSO" .IX Header "SEE ALSO" This module is part of Mail-Box distribution version 2.117, built on August 24, 2014. Website: \fIhttp://perl.overmeer.net/mailbox/\fR .SH "LICENSE" .IX Header "LICENSE" Copyrights 2001\-2014 by [Mark Overmeer]. For other contributors see ChangeLog. .PP This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See \fIhttp://www.perl.com/perl/misc/Artistic.html\fR