---
name: "Email::Folder"
section: "3pm"
platform: "linux"
package: "libemail-folder-perl"
version: "0.860-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Email::Folder"
---

# Email::Folder(3pm)

read all the messages from a folder as Email::Simple objects

## NAME

Email::Folder - read all the messages from a folder as Email::Simple objects

## VERSION

version 0.860

## SYNOPSIS

```
 use Email::Folder;
 my $folder = Email::Folder->new("some_file");
 print join "\n", map { $_->header("Subject") } $folder->messages;
```

## METHODS

### new($folder, %options)

Takes the name of a folder, and a hash of options

If a 'reader' option is passed in then that is used as the class to read in messages with.

### messages

Returns a list containing all of the messages in the folder.  Can only be called once as it drains the iterator.

### next\_message

acts as an iterator.  reads the next message from a folder.  returns false at the end of the folder

### bless\_message($message)

Takes a raw RFC822 message and blesses it into a class.

By default this is an Email::Simple object but can easily be overridden in a subclass.

For example, this simple subclass just returns the raw rfc822 messages, and exposes the speed of the parser.

```
 package Email::RawFolder;
 use base 'Email::Folder';
 sub bless_message { $_[1] };
 1;
```

### reader

read-only accessor to the underlying Email::Reader subclass instance

## SEE ALSO

Email::LocalDelivery, Email::FolderType, Email::Simple

## AUTHORS

- •

  Simon Wistow \<simon@thegestalt.org\>

- •

  Richard Clamp \<richardc@unixbeard.net\>

- •

  Pali \<pali@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2006 by Simon Wistow.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.