Mail::Box::Tie(3)     User Contributed Perl Documentation    Mail::Box::Tie(3)


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.

perl v5.42.2                      2026-04-11                 Mail::Box::Tie(3)