| 1 | package MIME::Body; | ||||||||||||||||||||||||||||
| 2 | |||||||||||||||||||||||||||||
| 3 | =head1 NAME | ||||||||||||||||||||||||||||
| 4 | |||||||||||||||||||||||||||||
| 5 | MIME::Body - the body of a MIME message | ||||||||||||||||||||||||||||
| 6 | |||||||||||||||||||||||||||||
| 7 | |||||||||||||||||||||||||||||
| 8 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||
| 9 | |||||||||||||||||||||||||||||
| 10 | Before reading further, you should see L<MIME::Tools> to make sure that | ||||||||||||||||||||||||||||
| 11 | you understand where this module fits into the grand scheme of things. | ||||||||||||||||||||||||||||
| 12 | Go on, do it now. I'll wait. | ||||||||||||||||||||||||||||
| 13 | |||||||||||||||||||||||||||||
| 14 | Ready? Ok... | ||||||||||||||||||||||||||||
| 15 | |||||||||||||||||||||||||||||
| 16 | |||||||||||||||||||||||||||||
| 17 | =head2 Obtaining bodies | ||||||||||||||||||||||||||||
| 18 | |||||||||||||||||||||||||||||
| 19 | ### Get the bodyhandle of a MIME::Entity object: | ||||||||||||||||||||||||||||
| 20 | $body = $entity->bodyhandle; | ||||||||||||||||||||||||||||
| 21 | |||||||||||||||||||||||||||||
| 22 | ### Create a body which stores data in a disk file: | ||||||||||||||||||||||||||||
| 23 | $body = new MIME::Body::File "/path/to/file"; | ||||||||||||||||||||||||||||
| 24 | |||||||||||||||||||||||||||||
| 25 | ### Create a body which stores data in an in-core array: | ||||||||||||||||||||||||||||
| 26 | $body = new MIME::Body::InCore \@strings; | ||||||||||||||||||||||||||||
| 27 | |||||||||||||||||||||||||||||
| 28 | |||||||||||||||||||||||||||||
| 29 | =head2 Opening, closing, and using IO handles | ||||||||||||||||||||||||||||
| 30 | |||||||||||||||||||||||||||||
| 31 | ### Write data to the body: | ||||||||||||||||||||||||||||
| 32 | $IO = $body->open("w") || die "open body: $!"; | ||||||||||||||||||||||||||||
| 33 | $IO->print($message); | ||||||||||||||||||||||||||||
| 34 | $IO->close || die "close I/O handle: $!"; | ||||||||||||||||||||||||||||
| 35 | |||||||||||||||||||||||||||||
| 36 | ### Read data from the body (in this case, line by line): | ||||||||||||||||||||||||||||
| 37 | $IO = $body->open("r") || die "open body: $!"; | ||||||||||||||||||||||||||||
| 38 | while (defined($_ = $IO->getline)) { | ||||||||||||||||||||||||||||
| 39 | ### do stuff | ||||||||||||||||||||||||||||
| 40 | } | ||||||||||||||||||||||||||||
| 41 | $IO->close || die "close I/O handle: $!"; | ||||||||||||||||||||||||||||
| 42 | |||||||||||||||||||||||||||||
| 43 | |||||||||||||||||||||||||||||
| 44 | =head2 Other I/O | ||||||||||||||||||||||||||||
| 45 | |||||||||||||||||||||||||||||
| 46 | ### Dump the ENCODED body data to a filehandle: | ||||||||||||||||||||||||||||
| 47 | $body->print(\*STDOUT); | ||||||||||||||||||||||||||||
| 48 | |||||||||||||||||||||||||||||
| 49 | ### Slurp all the UNENCODED data in, and put it in a scalar: | ||||||||||||||||||||||||||||
| 50 | $string = $body->as_string; | ||||||||||||||||||||||||||||
| 51 | |||||||||||||||||||||||||||||
| 52 | ### Slurp all the UNENCODED data in, and put it in an array of lines: | ||||||||||||||||||||||||||||
| 53 | @lines = $body->as_lines; | ||||||||||||||||||||||||||||
| 54 | |||||||||||||||||||||||||||||
| 55 | |||||||||||||||||||||||||||||
| 56 | =head2 Working directly with paths to underlying files | ||||||||||||||||||||||||||||
| 57 | |||||||||||||||||||||||||||||
| 58 | ### Where's the data? | ||||||||||||||||||||||||||||
| 59 | if (defined($body->path)) { ### data is on disk: | ||||||||||||||||||||||||||||
| 60 | print "data is stored externally, in ", $body->path; | ||||||||||||||||||||||||||||
| 61 | } | ||||||||||||||||||||||||||||
| 62 | else { ### data is in core: | ||||||||||||||||||||||||||||
| 63 | print "data is already in core, and is...\n", $body->as_string; | ||||||||||||||||||||||||||||
| 64 | } | ||||||||||||||||||||||||||||
| 65 | |||||||||||||||||||||||||||||
| 66 | ### Get rid of anything on disk: | ||||||||||||||||||||||||||||
| 67 | $body->purge; | ||||||||||||||||||||||||||||
| 68 | |||||||||||||||||||||||||||||
| 69 | |||||||||||||||||||||||||||||
| 70 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 71 | |||||||||||||||||||||||||||||
| 72 | MIME messages can be very long (e.g., tar files, MPEGs, etc.) or very | ||||||||||||||||||||||||||||
| 73 | short (short textual notes, as in ordinary mail). Long messages | ||||||||||||||||||||||||||||
| 74 | are best stored in files, while short ones are perhaps best stored | ||||||||||||||||||||||||||||
| 75 | in core. | ||||||||||||||||||||||||||||
| 76 | |||||||||||||||||||||||||||||
| 77 | This class is an attempt to define a common interface for objects | ||||||||||||||||||||||||||||
| 78 | which contain message data, regardless of how the data is | ||||||||||||||||||||||||||||
| 79 | physically stored. The lifespan of a "body" object | ||||||||||||||||||||||||||||
| 80 | usually looks like this: | ||||||||||||||||||||||||||||
| 81 | |||||||||||||||||||||||||||||
| 82 | =over 4 | ||||||||||||||||||||||||||||
| 83 | |||||||||||||||||||||||||||||
| 84 | =item 1. | ||||||||||||||||||||||||||||
| 85 | |||||||||||||||||||||||||||||
| 86 | B<Body object is created by a MIME::Parser during parsing.> | ||||||||||||||||||||||||||||
| 87 | It's at this point that the actual MIME::Body subclass is chosen, | ||||||||||||||||||||||||||||
| 88 | and new() is invoked. (For example: if the body data is going to | ||||||||||||||||||||||||||||
| 89 | a file, then it is at this point that the class MIME::Body::File, | ||||||||||||||||||||||||||||
| 90 | and the filename, is chosen). | ||||||||||||||||||||||||||||
| 91 | |||||||||||||||||||||||||||||
| 92 | =item 2. | ||||||||||||||||||||||||||||
| 93 | |||||||||||||||||||||||||||||
| 94 | B<Data is written to the body> (usually by the MIME parser) like this: | ||||||||||||||||||||||||||||
| 95 | The body is opened for writing, via C<open("w")>. This will trash any | ||||||||||||||||||||||||||||
| 96 | previous contents, and return an "I/O handle" opened for writing. | ||||||||||||||||||||||||||||
| 97 | Data is written to this I/O handle, via print(). | ||||||||||||||||||||||||||||
| 98 | Then the I/O handle is closed, via close(). | ||||||||||||||||||||||||||||
| 99 | |||||||||||||||||||||||||||||
| 100 | =item 3. | ||||||||||||||||||||||||||||
| 101 | |||||||||||||||||||||||||||||
| 102 | B<Data is read from the body> (usually by the user application) like this: | ||||||||||||||||||||||||||||
| 103 | The body is opened for reading by a user application, via C<open("r")>. | ||||||||||||||||||||||||||||
| 104 | This will return an "I/O handle" opened for reading. | ||||||||||||||||||||||||||||
| 105 | Data is read from the I/O handle, via read(), getline(), or getlines(). | ||||||||||||||||||||||||||||
| 106 | Then the I/O handle is closed, via close(). | ||||||||||||||||||||||||||||
| 107 | |||||||||||||||||||||||||||||
| 108 | =item 4. | ||||||||||||||||||||||||||||
| 109 | |||||||||||||||||||||||||||||
| 110 | B<Body object is destructed.> | ||||||||||||||||||||||||||||
| 111 | |||||||||||||||||||||||||||||
| 112 | =back | ||||||||||||||||||||||||||||
| 113 | |||||||||||||||||||||||||||||
| 114 | You can write your own subclasses, as long as they follow the | ||||||||||||||||||||||||||||
| 115 | interface described below. Implementers of subclasses should assume | ||||||||||||||||||||||||||||
| 116 | that steps 2 and 3 may be repeated any number of times, and in | ||||||||||||||||||||||||||||
| 117 | different orders (e.g., 1-2-2-3-2-3-3-3-3-3-2-4). | ||||||||||||||||||||||||||||
| 118 | |||||||||||||||||||||||||||||
| 119 | In any case, once a MIME::Body has been created, you ask to open it | ||||||||||||||||||||||||||||
| 120 | for reading or writing, which gets you an "i/o handle": you then use | ||||||||||||||||||||||||||||
| 121 | the same mechanisms for reading from or writing to that handle, no matter | ||||||||||||||||||||||||||||
| 122 | what class it is. | ||||||||||||||||||||||||||||
| 123 | |||||||||||||||||||||||||||||
| 124 | Beware: unless you know for certain what kind of body you have, you | ||||||||||||||||||||||||||||
| 125 | should I<not> assume that the body has an underlying filehandle. | ||||||||||||||||||||||||||||
| 126 | |||||||||||||||||||||||||||||
| 127 | |||||||||||||||||||||||||||||
| 128 | =head1 PUBLIC INTERFACE | ||||||||||||||||||||||||||||
| 129 | |||||||||||||||||||||||||||||
| 130 | =over 4 | ||||||||||||||||||||||||||||
| 131 | |||||||||||||||||||||||||||||
| 132 | =cut | ||||||||||||||||||||||||||||
| 133 | |||||||||||||||||||||||||||||
| 134 | |||||||||||||||||||||||||||||
| 135 | ### Pragmas: | ||||||||||||||||||||||||||||
| 136 | 31 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 137 | 31 | ▶ | use vars qw($VERSION); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 138 | |||||||||||||||||||||||||||||
| 139 | ### System modules: | ||||||||||||||||||||||||||||
| 140 | 31 | ▶ | use Carp; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 141 | 31 | ▶ | use IO::File; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 142 | |||||||||||||||||||||||||||||
| 143 | ### The package version, both in 1.23 style *and* usable by MakeMaker: | ||||||||||||||||||||||||||||
| 144 | 31 | $VERSION = "5.522"; | |||||||||||||||||||||||||||
| 145 | |||||||||||||||||||||||||||||
| 146 | |||||||||||||||||||||||||||||
| 147 | #------------------------------ | ||||||||||||||||||||||||||||
| 148 | |||||||||||||||||||||||||||||
| 149 | =item new ARGS... | ||||||||||||||||||||||||||||
| 150 | |||||||||||||||||||||||||||||
| 151 | I<Class method, constructor.> | ||||||||||||||||||||||||||||
| 152 | Create a new body. Any ARGS are sent to init(). | ||||||||||||||||||||||||||||
| 153 | |||||||||||||||||||||||||||||
| 154 | =cut | ||||||||||||||||||||||||||||
| 155 | |||||||||||||||||||||||||||||
| 156 | 2209 | ▶ | sub new { | ||||||||||||||||||||||||||
|
Subroutine
new: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 157 | 2209 | my $self = bless {}, shift; | |||||||||||||||||||||||||||
| 158 | 2209 | $self->init(@_); | |||||||||||||||||||||||||||
| 159 | 2209 | $self; | |||||||||||||||||||||||||||
| 160 | } | ||||||||||||||||||||||||||||
| 161 | |||||||||||||||||||||||||||||
| 162 | #------------------------------ | ||||||||||||||||||||||||||||
| 163 | |||||||||||||||||||||||||||||
| 164 | =item init ARGS... | ||||||||||||||||||||||||||||
| 165 | |||||||||||||||||||||||||||||
| 166 | I<Instance method, abstract, initiallizer.> | ||||||||||||||||||||||||||||
| 167 | This is called automatically by C<new()>, with the arguments given | ||||||||||||||||||||||||||||
| 168 | to C<new()>. The arguments are optional, and entirely up to the | ||||||||||||||||||||||||||||
| 169 | subclass. The default method does nothing, | ||||||||||||||||||||||||||||
| 170 | |||||||||||||||||||||||||||||
| 171 | =cut | ||||||||||||||||||||||||||||
| 172 | |||||||||||||||||||||||||||||
| 173 | 0 | ▶ | sub init { 1 } | ||||||||||||||||||||||||||
|
Subroutine
init: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 174 | |||||||||||||||||||||||||||||
| 175 | #------------------------------ | ||||||||||||||||||||||||||||
| 176 | |||||||||||||||||||||||||||||
| 177 | =item as_lines | ||||||||||||||||||||||||||||
| 178 | |||||||||||||||||||||||||||||
| 179 | I<Instance method.> | ||||||||||||||||||||||||||||
| 180 | Return the contents of the body as an array of lines (each terminated | ||||||||||||||||||||||||||||
| 181 | by a newline, with the possible exception of the final one). | ||||||||||||||||||||||||||||
| 182 | Returns empty on failure (NB: indistinguishable from an empty body!). | ||||||||||||||||||||||||||||
| 183 | |||||||||||||||||||||||||||||
| 184 | Note: the default method gets the data via | ||||||||||||||||||||||||||||
| 185 | repeated getline() calls; your subclass might wish to override this. | ||||||||||||||||||||||||||||
| 186 | |||||||||||||||||||||||||||||
| 187 | =cut | ||||||||||||||||||||||||||||
| 188 | |||||||||||||||||||||||||||||
| 189 | 7 | ▶ | sub as_lines { | ||||||||||||||||||||||||||
|
Subroutine
as_lines: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||||||||||||||||||
| 190 | 7 | my $self = shift; | |||||||||||||||||||||||||||
| 191 | 7 | my @lines; | |||||||||||||||||||||||||||
| 192 | 7 | ▶ | my $io = $self->open("r") || return (); | ||||||||||||||||||||||||||
|
Condition50%1/2
$self->open('r') || (return ())
MC/DC0%0/1
$self->open('r') || (return ())
$self->open('r')
Truth table50%1/2
A
A= $self->open('r')
| |||||||||||||||||||||||||||||
| 193 | 7 | local $_; | |||||||||||||||||||||||||||
| 194 | 7 | ▶ | push @lines, $_ while (defined($_ = $io->getline())); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 195 | 7 | $io->close; | |||||||||||||||||||||||||||
| 196 | 7 | @lines; | |||||||||||||||||||||||||||
| 197 | } | ||||||||||||||||||||||||||||
| 198 | |||||||||||||||||||||||||||||
| 199 | #------------------------------ | ||||||||||||||||||||||||||||
| 200 | |||||||||||||||||||||||||||||
| 201 | =item as_string | ||||||||||||||||||||||||||||
| 202 | |||||||||||||||||||||||||||||
| 203 | I<Instance method.> | ||||||||||||||||||||||||||||
| 204 | Return the body data as a string (slurping it into core if necessary). | ||||||||||||||||||||||||||||
| 205 | Best not to do this unless you're I<sure> that the body is reasonably small! | ||||||||||||||||||||||||||||
| 206 | Returns empty string for an empty body, and undef on failure. | ||||||||||||||||||||||||||||
| 207 | |||||||||||||||||||||||||||||
| 208 | Note: the default method uses print(), which gets the data via | ||||||||||||||||||||||||||||
| 209 | repeated read() calls; your subclass might wish to override this. | ||||||||||||||||||||||||||||
| 210 | |||||||||||||||||||||||||||||
| 211 | =cut | ||||||||||||||||||||||||||||
| 212 | |||||||||||||||||||||||||||||
| 213 | 10 | ▶ | sub as_string { | ||||||||||||||||||||||||||
|
Subroutine
as_string: called CC=2 SCAR=7.0
Pod
documented
| |||||||||||||||||||||||||||||
| 214 | 10 | my $self = shift; | |||||||||||||||||||||||||||
| 215 | 10 | my $str = ''; | |||||||||||||||||||||||||||
| 216 | 10 | ▶ | my $fh = IO::File->new(\$str, '>:') or croak("Cannot open in-memory file: $!"); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 217 | 10 | $self->print($fh); | |||||||||||||||||||||||||||
| 218 | 10 | close($fh); | |||||||||||||||||||||||||||
| 219 | 10 | return $str; | |||||||||||||||||||||||||||
| 220 | } | ||||||||||||||||||||||||||||
| 221 | 31 | *data = \&as_string; ### silently invoke preferred usage | |||||||||||||||||||||||||||
| 222 | |||||||||||||||||||||||||||||
| 223 | |||||||||||||||||||||||||||||
| 224 | #------------------------------ | ||||||||||||||||||||||||||||
| 225 | |||||||||||||||||||||||||||||
| 226 | =item binmode [ONOFF] | ||||||||||||||||||||||||||||
| 227 | |||||||||||||||||||||||||||||
| 228 | I<Instance method.> | ||||||||||||||||||||||||||||
| 229 | With argument, flags whether or not open() should return an I/O handle | ||||||||||||||||||||||||||||
| 230 | which has binmode() activated. With no argument, just returns the | ||||||||||||||||||||||||||||
| 231 | current value. | ||||||||||||||||||||||||||||
| 232 | |||||||||||||||||||||||||||||
| 233 | =cut | ||||||||||||||||||||||||||||
| 234 | |||||||||||||||||||||||||||||
| 235 | 203 | ▶ | sub binmode { | ||||||||||||||||||||||||||
|
Subroutine
binmode: called CC=2 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 236 | 203 | my ($self, $onoff) = @_; | |||||||||||||||||||||||||||
| 237 | 203 | ▶ | $self->{MB_Binmode} = $onoff if (@_ > 1); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 238 | 203 | $self->{MB_Binmode}; | |||||||||||||||||||||||||||
| 239 | } | ||||||||||||||||||||||||||||
| 240 | |||||||||||||||||||||||||||||
| 241 | #------------------------------ | ||||||||||||||||||||||||||||
| 242 | |||||||||||||||||||||||||||||
| 243 | =item is_encoded [ONOFF] | ||||||||||||||||||||||||||||
| 244 | |||||||||||||||||||||||||||||
| 245 | I<Instance method.> | ||||||||||||||||||||||||||||
| 246 | If set to yes, no decoding is applied on output. This flag is set | ||||||||||||||||||||||||||||
| 247 | by MIME::Parser, if the parser runs in decode_bodies(0) mode, so the | ||||||||||||||||||||||||||||
| 248 | content is handled unmodified. | ||||||||||||||||||||||||||||
| 249 | |||||||||||||||||||||||||||||
| 250 | =cut | ||||||||||||||||||||||||||||
| 251 | |||||||||||||||||||||||||||||
| 252 | 82 | ▶ | sub is_encoded { | ||||||||||||||||||||||||||
|
Subroutine
is_encoded: called CC=2 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 253 | 82 | my ($self, $yesno) = @_; | |||||||||||||||||||||||||||
| 254 | 82 | ▶ | $self->{MB_IsEncoded} = $yesno if (@_ > 1); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 255 | 82 | $self->{MB_IsEncoded}; | |||||||||||||||||||||||||||
| 256 | } | ||||||||||||||||||||||||||||
| 257 | |||||||||||||||||||||||||||||
| 258 | #------------------------------ | ||||||||||||||||||||||||||||
| 259 | |||||||||||||||||||||||||||||
| 260 | =item dup | ||||||||||||||||||||||||||||
| 261 | |||||||||||||||||||||||||||||
| 262 | I<Instance method.> | ||||||||||||||||||||||||||||
| 263 | Duplicate the bodyhandle. | ||||||||||||||||||||||||||||
| 264 | |||||||||||||||||||||||||||||
| 265 | I<Beware:> external data in bodyhandles is I<not> copied to new files! | ||||||||||||||||||||||||||||
| 266 | Changing the data in one body's data file, or purging that body, | ||||||||||||||||||||||||||||
| 267 | I<will> affect its duplicate. Bodies with in-core data probably need | ||||||||||||||||||||||||||||
| 268 | not worry. | ||||||||||||||||||||||||||||
| 269 | |||||||||||||||||||||||||||||
| 270 | =cut | ||||||||||||||||||||||||||||
| 271 | |||||||||||||||||||||||||||||
| 272 | 4 | ▶ | sub dup { | ||||||||||||||||||||||||||
|
Subroutine
dup: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 273 | 4 | my $self = shift; | |||||||||||||||||||||||||||
| 274 | 4 | bless { %$self }, ref($self); ### shallow copy ok for ::File and ::Scalar | |||||||||||||||||||||||||||
| 275 | } | ||||||||||||||||||||||||||||
| 276 | |||||||||||||||||||||||||||||
| 277 | #------------------------------ | ||||||||||||||||||||||||||||
| 278 | |||||||||||||||||||||||||||||
| 279 | =item open READWRITE | ||||||||||||||||||||||||||||
| 280 | |||||||||||||||||||||||||||||
| 281 | I<Instance method, abstract.> | ||||||||||||||||||||||||||||
| 282 | This should do whatever is necessary to open the body for either | ||||||||||||||||||||||||||||
| 283 | writing (if READWRITE is "w") or reading (if mode is "r"). | ||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||
| 285 | This method is expected to return an "I/O handle" object on success, | ||||||||||||||||||||||||||||
| 286 | and undef on error. An I/O handle can be any object that supports a | ||||||||||||||||||||||||||||
| 287 | small set of standard methods for reading/writing data. | ||||||||||||||||||||||||||||
| 288 | See the IO::Handle class for an example. | ||||||||||||||||||||||||||||
| 289 | |||||||||||||||||||||||||||||
| 290 | =cut | ||||||||||||||||||||||||||||
| 291 | |||||||||||||||||||||||||||||
| 292 | 0 | ▶ | sub open { | ||||||||||||||||||||||||||
|
Subroutine
open: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 293 | 0 | undef; | |||||||||||||||||||||||||||
| 294 | } | ||||||||||||||||||||||||||||
| 295 | |||||||||||||||||||||||||||||
| 296 | #------------------------------ | ||||||||||||||||||||||||||||
| 297 | |||||||||||||||||||||||||||||
| 298 | =item path [PATH] | ||||||||||||||||||||||||||||
| 299 | |||||||||||||||||||||||||||||
| 300 | I<Instance method.> | ||||||||||||||||||||||||||||
| 301 | If you're storing the body data externally (e.g., in a disk file), you'll | ||||||||||||||||||||||||||||
| 302 | want to give applications the ability to get at that data, for cleanup. | ||||||||||||||||||||||||||||
| 303 | This method should return the path to the data, or undef if there is none. | ||||||||||||||||||||||||||||
| 304 | |||||||||||||||||||||||||||||
| 305 | Where appropriate, the path I<should> be a simple string, like a filename. | ||||||||||||||||||||||||||||
| 306 | With argument, sets the PATH, which should be undef if there is none. | ||||||||||||||||||||||||||||
| 307 | |||||||||||||||||||||||||||||
| 308 | =cut | ||||||||||||||||||||||||||||
| 309 | |||||||||||||||||||||||||||||
| 310 | 338 | ▶ | sub path { | ||||||||||||||||||||||||||
|
Subroutine
path: called CC=2 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 311 | 338 | my $self = shift; | |||||||||||||||||||||||||||
| 312 | 338 | ▶ | $self->{MB_Path} = shift if @_; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 313 | 338 | $self->{MB_Path}; | |||||||||||||||||||||||||||
| 314 | } | ||||||||||||||||||||||||||||
| 315 | |||||||||||||||||||||||||||||
| 316 | #------------------------------ | ||||||||||||||||||||||||||||
| 317 | |||||||||||||||||||||||||||||
| 318 | =item print FILEHANDLE | ||||||||||||||||||||||||||||
| 319 | |||||||||||||||||||||||||||||
| 320 | I<Instance method.> | ||||||||||||||||||||||||||||
| 321 | Output the body data to the given filehandle, or to the currently-selected | ||||||||||||||||||||||||||||
| 322 | one if none is given. | ||||||||||||||||||||||||||||
| 323 | |||||||||||||||||||||||||||||
| 324 | =cut | ||||||||||||||||||||||||||||
| 325 | |||||||||||||||||||||||||||||
| 326 | 19 | ▶ | sub print { | ||||||||||||||||||||||||||
|
Subroutine
print: called CC=4 SCAR=14.2
Pod
documented
| |||||||||||||||||||||||||||||
| 327 | 19 | my ($self, $fh) = @_; | |||||||||||||||||||||||||||
| 328 | 19 | my $nread; | |||||||||||||||||||||||||||
| 329 | |||||||||||||||||||||||||||||
| 330 | ### Get output filehandle, and ensure that it's a printable object: | ||||||||||||||||||||||||||||
| 331 | 19 | ▶ | $fh ||= select; | ||||||||||||||||||||||||||
|
Condition33%1/3
$fh ||= select
MC/DC0%0/2
$fh ||= select
$fh
select
Truth table33%1/3
A ||= B
A= $fhB= select
| |||||||||||||||||||||||||||||
| 332 | |||||||||||||||||||||||||||||
| 333 | ### Write it: | ||||||||||||||||||||||||||||
| 334 | 19 | my $buf = ''; | |||||||||||||||||||||||||||
| 335 | 19 | ▶ | my $io = $self->open("r") || return undef; | ||||||||||||||||||||||||||
|
Condition50%1/2
$self->open('r') || (return undef)
MC/DC0%0/1
$self->open('r') || (return undef)
$self->open('r')
Truth table50%1/2
A
A= $self->open('r')
| |||||||||||||||||||||||||||||
| 336 | 19 | ▶ | $fh->print($buf) while ($nread = $io->read($buf, 8192)); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 337 | 19 | $io->close; | |||||||||||||||||||||||||||
| 338 | 19 | return defined($nread); ### how'd we do? | |||||||||||||||||||||||||||
| 339 | } | ||||||||||||||||||||||||||||
| 340 | |||||||||||||||||||||||||||||
| 341 | #------------------------------ | ||||||||||||||||||||||||||||
| 342 | |||||||||||||||||||||||||||||
| 343 | =item purge | ||||||||||||||||||||||||||||
| 344 | |||||||||||||||||||||||||||||
| 345 | I<Instance method, abstract.> | ||||||||||||||||||||||||||||
| 346 | Remove any data which resides external to the program (e.g., in disk files). | ||||||||||||||||||||||||||||
| 347 | Immediately after a purge(), the path() should return undef to indicate | ||||||||||||||||||||||||||||
| 348 | that the external data is no longer available. | ||||||||||||||||||||||||||||
| 349 | |||||||||||||||||||||||||||||
| 350 | =cut | ||||||||||||||||||||||||||||
| 351 | |||||||||||||||||||||||||||||
| 352 | 0 | ▶ | sub purge { | ||||||||||||||||||||||||||
|
Subroutine
purge: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 353 | 0 | 1; | |||||||||||||||||||||||||||
| 354 | } | ||||||||||||||||||||||||||||
| 355 | |||||||||||||||||||||||||||||
| 356 | |||||||||||||||||||||||||||||
| 357 | |||||||||||||||||||||||||||||
| 358 | =back | ||||||||||||||||||||||||||||
| 359 | |||||||||||||||||||||||||||||
| 360 | =head1 SUBCLASSES | ||||||||||||||||||||||||||||
| 361 | |||||||||||||||||||||||||||||
| 362 | The following built-in classes are provided: | ||||||||||||||||||||||||||||
| 363 | |||||||||||||||||||||||||||||
| 364 | Body Stores body When open()ed, | ||||||||||||||||||||||||||||
| 365 | class: data in: returns: | ||||||||||||||||||||||||||||
| 366 | -------------------------------------------------------- | ||||||||||||||||||||||||||||
| 367 | MIME::Body::File disk file IO::Handle | ||||||||||||||||||||||||||||
| 368 | MIME::Body::Scalar scalar IO::Handle | ||||||||||||||||||||||||||||
| 369 | MIME::Body::InCore scalar array IO::Handle | ||||||||||||||||||||||||||||
| 370 | |||||||||||||||||||||||||||||
| 371 | =cut | ||||||||||||||||||||||||||||
| 372 | |||||||||||||||||||||||||||||
| 373 | |||||||||||||||||||||||||||||
| 374 | #------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 375 | package MIME::Body::File; | ||||||||||||||||||||||||||||
| 376 | #------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 377 | |||||||||||||||||||||||||||||
| 378 | =head2 MIME::Body::File | ||||||||||||||||||||||||||||
| 379 | |||||||||||||||||||||||||||||
| 380 | A body class that stores the data in a disk file. Invoke the | ||||||||||||||||||||||||||||
| 381 | constructor as: | ||||||||||||||||||||||||||||
| 382 | |||||||||||||||||||||||||||||
| 383 | $body = new MIME::Body::File "/path/to/file"; | ||||||||||||||||||||||||||||
| 384 | |||||||||||||||||||||||||||||
| 385 | In this case, the C<path()> method would return the given path, | ||||||||||||||||||||||||||||
| 386 | so you I<could> say: | ||||||||||||||||||||||||||||
| 387 | |||||||||||||||||||||||||||||
| 388 | if (defined($body->path)) { | ||||||||||||||||||||||||||||
| 389 | open BODY, $body->path or die "open: $!"; | ||||||||||||||||||||||||||||
| 390 | while (<BODY>) { | ||||||||||||||||||||||||||||
| 391 | ### do stuff | ||||||||||||||||||||||||||||
| 392 | } | ||||||||||||||||||||||||||||
| 393 | close BODY; | ||||||||||||||||||||||||||||
| 394 | } | ||||||||||||||||||||||||||||
| 395 | |||||||||||||||||||||||||||||
| 396 | But you're best off not doing this. | ||||||||||||||||||||||||||||
| 397 | |||||||||||||||||||||||||||||
| 398 | =cut | ||||||||||||||||||||||||||||
| 399 | |||||||||||||||||||||||||||||
| 400 | |||||||||||||||||||||||||||||
| 401 | ### Pragmas: | ||||||||||||||||||||||||||||
| 402 | 31 | ▶ | use vars qw(@ISA); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 403 | 31 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 404 | |||||||||||||||||||||||||||||
| 405 | ### System modules: | ||||||||||||||||||||||||||||
| 406 | 31 | ▶ | use IO::File; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 407 | |||||||||||||||||||||||||||||
| 408 | ### Kit modules: | ||||||||||||||||||||||||||||
| 409 | 31 | ▶ | use MIME::Tools qw(whine); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 410 | |||||||||||||||||||||||||||||
| 411 | 31 | @ISA = qw(MIME::Body); | |||||||||||||||||||||||||||
| 412 | |||||||||||||||||||||||||||||
| 413 | |||||||||||||||||||||||||||||
| 414 | #------------------------------ | ||||||||||||||||||||||||||||
| 415 | # init PATH | ||||||||||||||||||||||||||||
| 416 | #------------------------------ | ||||||||||||||||||||||||||||
| 417 | 113 | ▶ | sub init { | ||||||||||||||||||||||||||
|
Subroutine
init: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 418 | 113 | my ($self, $path) = @_; | |||||||||||||||||||||||||||
| 419 | 113 | $self->path($path); ### use it as-is | |||||||||||||||||||||||||||
| 420 | 113 | $self; | |||||||||||||||||||||||||||
| 421 | } | ||||||||||||||||||||||||||||
| 422 | |||||||||||||||||||||||||||||
| 423 | #------------------------------ | ||||||||||||||||||||||||||||
| 424 | # open READWRITE | ||||||||||||||||||||||||||||
| 425 | #------------------------------ | ||||||||||||||||||||||||||||
| 426 | 151 | ▶ | sub open { | ||||||||||||||||||||||||||
|
Subroutine
open: called CC=5 SCAR=16.8
| |||||||||||||||||||||||||||||
| 427 | 151 | my ($self, $mode) = @_; | |||||||||||||||||||||||||||
| 428 | |||||||||||||||||||||||||||||
| 429 | 151 | my $path = $self->path; | |||||||||||||||||||||||||||
| 430 | |||||||||||||||||||||||||||||
| 431 | 151 | ▶ | if( $mode ne 'r' && $mode ne 'w' ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$mode ne "r" and $mode ne "w"
MC/DC0%0/2
$mode ne "r" and $mode ne "w"
$mode ne "r"
$mode ne "w"
Truth table66%2/3
A and B
A= $mode ne "r"B= $mode ne "w"
| |||||||||||||||||||||||||||||
| 432 | 0 | die "bad mode: '$mode'"; | |||||||||||||||||||||||||||
| 433 | } | ||||||||||||||||||||||||||||
| 434 | |||||||||||||||||||||||||||||
| 435 | 151 | ▶ | my $IO = IO::File->new($path, $mode) || die "MIME::Body::File->open $path: $!"; | ||||||||||||||||||||||||||
|
Condition50%1/2
'IO::File'->new($path, $mode) || die("MIME::Body::File->open ${path}: $!")
MC/DC0%0/1
'IO::File'->new($path, $mode) || die("MIME::Body::File->open ${path}: $!")
'IO::File'->new($path, $mode)
Truth table50%1/2
A
A= 'IO::File'->new($path, $mode)
| |||||||||||||||||||||||||||||
| 436 | |||||||||||||||||||||||||||||
| 437 | 151 | ▶ | $IO->binmode() if $self->binmode; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 438 | |||||||||||||||||||||||||||||
| 439 | 151 | return $IO; | |||||||||||||||||||||||||||
| 440 | } | ||||||||||||||||||||||||||||
| 441 | |||||||||||||||||||||||||||||
| 442 | #------------------------------ | ||||||||||||||||||||||||||||
| 443 | # purge | ||||||||||||||||||||||||||||
| 444 | #------------------------------ | ||||||||||||||||||||||||||||
| 445 | # Unlink the path (and undefine it). | ||||||||||||||||||||||||||||
| 446 | # | ||||||||||||||||||||||||||||
| 447 | 3 | ▶ | sub purge { | ||||||||||||||||||||||||||
|
Subroutine
purge: called CC=3 SCAR=11.3
| |||||||||||||||||||||||||||||
| 448 | 3 | my $self = shift; | |||||||||||||||||||||||||||
| 449 | 3 | ▶ | if (defined($self->path)) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 450 | 3 | ▶ | unlink $self->path or whine "couldn't unlink ".$self->path.": $!"; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 451 | 3 | $self->path(undef); | |||||||||||||||||||||||||||
| 452 | } | ||||||||||||||||||||||||||||
| 453 | 3 | 1; | |||||||||||||||||||||||||||
| 454 | } | ||||||||||||||||||||||||||||
| 455 | |||||||||||||||||||||||||||||
| 456 | |||||||||||||||||||||||||||||
| 457 | |||||||||||||||||||||||||||||
| 458 | |||||||||||||||||||||||||||||
| 459 | #------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 460 | package MIME::Body::Scalar; | ||||||||||||||||||||||||||||
| 461 | #------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 462 | |||||||||||||||||||||||||||||
| 463 | =head2 MIME::Body::Scalar | ||||||||||||||||||||||||||||
| 464 | |||||||||||||||||||||||||||||
| 465 | A body class that stores the data in-core, in a simple scalar. | ||||||||||||||||||||||||||||
| 466 | Invoke the constructor as: | ||||||||||||||||||||||||||||
| 467 | |||||||||||||||||||||||||||||
| 468 | $body = new MIME::Body::Scalar \$string; | ||||||||||||||||||||||||||||
| 469 | |||||||||||||||||||||||||||||
| 470 | A single scalar argument sets the body to that value, exactly as though | ||||||||||||||||||||||||||||
| 471 | you'd opened for the body for writing, written the value, | ||||||||||||||||||||||||||||
| 472 | and closed the body again: | ||||||||||||||||||||||||||||
| 473 | |||||||||||||||||||||||||||||
| 474 | $body = new MIME::Body::Scalar "Line 1\nLine 2\nLine 3"; | ||||||||||||||||||||||||||||
| 475 | |||||||||||||||||||||||||||||
| 476 | A single array reference sets the body to the result of joining all the | ||||||||||||||||||||||||||||
| 477 | elements of that array together: | ||||||||||||||||||||||||||||
| 478 | |||||||||||||||||||||||||||||
| 479 | $body = new MIME::Body::Scalar ["Line 1\n", | ||||||||||||||||||||||||||||
| 480 | "Line 2\n", | ||||||||||||||||||||||||||||
| 481 | "Line 3"]; | ||||||||||||||||||||||||||||
| 482 | |||||||||||||||||||||||||||||
| 483 | =cut | ||||||||||||||||||||||||||||
| 484 | |||||||||||||||||||||||||||||
| 485 | 31 | ▶ | use vars qw(@ISA); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 486 | 31 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 487 | |||||||||||||||||||||||||||||
| 488 | 31 | ▶ | use Carp; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 489 | |||||||||||||||||||||||||||||
| 490 | 31 | @ISA = qw(MIME::Body); | |||||||||||||||||||||||||||
| 491 | |||||||||||||||||||||||||||||
| 492 | |||||||||||||||||||||||||||||
| 493 | #------------------------------ | ||||||||||||||||||||||||||||
| 494 | # init DATA | ||||||||||||||||||||||||||||
| 495 | #------------------------------ | ||||||||||||||||||||||||||||
| 496 | 2 | ▶ | sub init { | ||||||||||||||||||||||||||
|
Subroutine
init: called CC=4 SCAR=15.6
| |||||||||||||||||||||||||||||
| 497 | 2 | my ($self, $data) = @_; | |||||||||||||||||||||||||||
| 498 | 2 | ▶ | $data = join('', @$data) if (ref($data) && (ref($data) eq 'ARRAY')); | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
ref $data and ref $data eq "ARRAY"
MC/DC0%0/2
ref $data and ref $data eq "ARRAY"
ref $data
ref $data eq "ARRAY"
Truth table33%1/3
A and B
A= ref $dataB= ref $data eq "ARRAY"
| |||||||||||||||||||||||||||||
| 499 | 2 | ▶ | $self->{MBS_Data} = (defined($data) ? $data : ''); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 500 | 2 | $self; | |||||||||||||||||||||||||||
| 501 | } | ||||||||||||||||||||||||||||
| 502 | |||||||||||||||||||||||||||||
| 503 | #------------------------------ | ||||||||||||||||||||||||||||
| 504 | # as_string | ||||||||||||||||||||||||||||
| 505 | #------------------------------ | ||||||||||||||||||||||||||||
| 506 | 4 | ▶ | sub as_string { | ||||||||||||||||||||||||||
|
Subroutine
as_string: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 507 | 4 | shift->{MBS_Data}; | |||||||||||||||||||||||||||
| 508 | } | ||||||||||||||||||||||||||||
| 509 | |||||||||||||||||||||||||||||
| 510 | #------------------------------ | ||||||||||||||||||||||||||||
| 511 | # open READWRITE | ||||||||||||||||||||||||||||
| 512 | #------------------------------ | ||||||||||||||||||||||||||||
| 513 | 2135 | ▶ | sub open { | ||||||||||||||||||||||||||
|
Subroutine
open: called CC=4 SCAR=14.0
| |||||||||||||||||||||||||||||
| 514 | 2135 | my ($self, $mode) = @_; | |||||||||||||||||||||||||||
| 515 | 2135 | ▶ | $self->{MBS_Data} = '' if ($mode eq 'w'); ### writing | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 516 | |||||||||||||||||||||||||||||
| 517 | 2135 | ▶ | if ($mode eq 'w') { | ||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||
| 518 | 2075 | $mode = '>:'; | |||||||||||||||||||||||||||
| 519 | } elsif ($mode eq 'r') { | ||||||||||||||||||||||||||||
| 520 | 60 | $mode = '<:'; | |||||||||||||||||||||||||||
| 521 | } else { | ||||||||||||||||||||||||||||
| 522 | 0 | die "bad mode: $mode"; | |||||||||||||||||||||||||||
| 523 | } | ||||||||||||||||||||||||||||
| 524 | |||||||||||||||||||||||||||||
| 525 | 2135 | return IO::File->new(\ $self->{MBS_Data}, $mode); | |||||||||||||||||||||||||||
| 526 | } | ||||||||||||||||||||||||||||
| 527 | |||||||||||||||||||||||||||||
| 528 | |||||||||||||||||||||||||||||
| 529 | |||||||||||||||||||||||||||||
| 530 | |||||||||||||||||||||||||||||
| 531 | |||||||||||||||||||||||||||||
| 532 | #------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 533 | package MIME::Body::InCore; | ||||||||||||||||||||||||||||
| 534 | #------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 535 | |||||||||||||||||||||||||||||
| 536 | =head2 MIME::Body::InCore | ||||||||||||||||||||||||||||
| 537 | |||||||||||||||||||||||||||||
| 538 | A body class that stores the data in-core. | ||||||||||||||||||||||||||||
| 539 | Invoke the constructor as: | ||||||||||||||||||||||||||||
| 540 | |||||||||||||||||||||||||||||
| 541 | $body = new MIME::Body::InCore \$string; | ||||||||||||||||||||||||||||
| 542 | $body = new MIME::Body::InCore $string; | ||||||||||||||||||||||||||||
| 543 | $body = new MIME::Body::InCore \@stringarray | ||||||||||||||||||||||||||||
| 544 | |||||||||||||||||||||||||||||
| 545 | A simple scalar argument sets the body to that value, exactly as though | ||||||||||||||||||||||||||||
| 546 | you'd opened for the body for writing, written the value, | ||||||||||||||||||||||||||||
| 547 | and closed the body again: | ||||||||||||||||||||||||||||
| 548 | |||||||||||||||||||||||||||||
| 549 | $body = new MIME::Body::InCore "Line 1\nLine 2\nLine 3"; | ||||||||||||||||||||||||||||
| 550 | |||||||||||||||||||||||||||||
| 551 | A single array reference sets the body to the concatenation of all | ||||||||||||||||||||||||||||
| 552 | scalars that it holds: | ||||||||||||||||||||||||||||
| 553 | |||||||||||||||||||||||||||||
| 554 | $body = new MIME::Body::InCore ["Line 1\n", | ||||||||||||||||||||||||||||
| 555 | "Line 2\n", | ||||||||||||||||||||||||||||
| 556 | "Line 3"]; | ||||||||||||||||||||||||||||
| 557 | |||||||||||||||||||||||||||||
| 558 | =cut | ||||||||||||||||||||||||||||
| 559 | |||||||||||||||||||||||||||||
| 560 | 31 | ▶ | use vars qw(@ISA); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 561 | 31 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 562 | |||||||||||||||||||||||||||||
| 563 | 31 | ▶ | use Carp; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 564 | |||||||||||||||||||||||||||||
| 565 | 31 | @ISA = qw(MIME::Body::Scalar); | |||||||||||||||||||||||||||
| 566 | |||||||||||||||||||||||||||||
| 567 | |||||||||||||||||||||||||||||
| 568 | #------------------------------ | ||||||||||||||||||||||||||||
| 569 | # init DATA | ||||||||||||||||||||||||||||
| 570 | #------------------------------ | ||||||||||||||||||||||||||||
| 571 | 2094 | ▶ | sub init { | ||||||||||||||||||||||||||
|
Subroutine
init: called CC=5 SCAR=16.2
| |||||||||||||||||||||||||||||
| 572 | 2094 | my ($self, $data) = @_; | |||||||||||||||||||||||||||
| 573 | 2094 | ▶ | if (!defined($data)) { ### nothing | ||||||||||||||||||||||||||
|
Branch: 4 branches
| |||||||||||||||||||||||||||||
| 574 | 2073 | $self->{MBS_Data} = ''; | |||||||||||||||||||||||||||
| 575 | } | ||||||||||||||||||||||||||||
| 576 | elsif (!ref($data)) { ### simple scalar | ||||||||||||||||||||||||||||
| 577 | 11 | $self->{MBS_Data} = $data; | |||||||||||||||||||||||||||
| 578 | } | ||||||||||||||||||||||||||||
| 579 | elsif (ref($data) eq 'SCALAR') { | ||||||||||||||||||||||||||||
| 580 | 1 | $self->{MBS_Data} = $$data; | |||||||||||||||||||||||||||
| 581 | } | ||||||||||||||||||||||||||||
| 582 | elsif (ref($data) eq 'ARRAY') { | ||||||||||||||||||||||||||||
| 583 | 9 | $self->{MBS_Data} = join('', @$data); | |||||||||||||||||||||||||||
| 584 | } | ||||||||||||||||||||||||||||
| 585 | else { | ||||||||||||||||||||||||||||
| 586 | 0 | croak "I can't handle DATA which is a ".ref($data)."\n"; | |||||||||||||||||||||||||||
| 587 | } | ||||||||||||||||||||||||||||
| 588 | 2094 | $self; | |||||||||||||||||||||||||||
| 589 | } | ||||||||||||||||||||||||||||
| 590 | |||||||||||||||||||||||||||||
| 591 | 31 | 1; | |||||||||||||||||||||||||||
| 592 | __END__ | ||||||||||||||||||||||||||||