View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Dave Rolsky > Courriel > Courriel::Part::Multipart



Annotate this POD


View/Report Bugs
Module Version: 0.47   Source  


Courriel::Part::Multipart - A part which contains other parts


version 0.47


  my $headers = $part->headers;
  my $ct = $part->content_type;

  for my $subpart ( $part->parts ) { ... }


This class represents a multipart email part which contains other parts.


This class provides the following methods:

Courriel::Part::Multipart->new( ... )

This method creates a new part object. It accepts the following parameters:


Returns an array (not a reference) of the parts this part contains.


Returns the number of parts this part contains.


Returns the part boundary.


Returns the mime type for this part.


Returns the Courriel::Header::ContentType object for this part.


Returns the Courriel::Headers object for this part.

$part->is_inline(), $part->is_attachment()

These methods always return false, but exist for the sake of providing a consistent API between Single and Multipart part objects.


Returns true.


The preamble as passed to the constructor.


The epilogue as passed to the constructor.


Returns the Courriel or Courriel::Part::Multipart object to which this part belongs, if any. This is set when the part is added to another object.

$part->stream_to( output => $output )

This method will send the stringified part to the specified output. The output can be a subroutine reference, a filehandle, or an object with a print() method. The output may be sent as a single string, as a list of strings, or via multiple calls to the output.


Returns the part as a string, along with its headers. Lines will be terminated with "\r\n".


This class does the Courriel::Role::Part and Courriel::Role::Streams roles.


Bugs may be submitted at

I am also usually active on IRC as 'autarch' on irc://


The source code repository for Courriel can be found at


Dave Rolsky <>


This software is Copyright (c) 2018 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

The full text of the license can be found in the LICENSE file included with this distribution.

syntax highlighting: