---
name: "Mail::Box::Tie"
section: "3pm"
platform: "linux"
package: "perl-mail-box"
version: "4.02-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Mail::Box::Tie"
---

# Mail::Box::Tie(3pm)

access an existing message-folder as an array or hash

## NAME

Mail::Box::Tie - access an existing message-folder as an array or hash

## INHERITANCE

```
 Mail::Box::Tie is extended by
   Mail::Box::Tie::ARRAY
   Mail::Box::Tie::HASH
```

## SYNOPSIS

As an array:

```
  tie my(@inbox), Mail::Box::Tie::ARRAY => $folder;
  print $inbox[3];
```

or as hash:

```
  tie my(%inbox), Mail::Box::Tie::HASH => $folder;
  print $inbox{'<12379.124879@example.com>'};
```

## DESCRIPTION

Folders certainly look like an array of messages, so why not just access them as one?  Or, the order is not important, but the message-ids are (give relations): why not access them from a hash based on this message-id?  Programs using one of these ties will look simpler than programs using the more traditional method calls.

## METHODS

### Constructors

- $class-\>**new**($folder, $type)

  Do not call this method directly, but via the tie interface.

### Attributes

- $obj-\>**folder**()

  - $obj-\>**type**()

  ## DIAGNOSTICS

- Error: no folder specified to tie to.

  Cast by `new()`

## SEE ALSO

This module is part of Mail-Box version 4.02, built on April 10, 2026. Website: *http://perl.overmeer.net/CPAN/*

## LICENSE

For contributors see file ChangeLog.

This software is copyright (c) 2001-2026 by Mark Overmeer.

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