Reference: new
Author: Ellen Siever, Stephen Spainhour & Nathan Patwardhan
Date: 1999-07-02T01:56:43Z

#

| Chapter 14 Email Connectivity |

## new

     $folder = new(ftype[, foldername][, options])

Creates a new Mail::Folder object of the specified type. Arguments are:

ftype

  The type of folder. Possible values are `mbox`, `maildir`, `emaul`, or `NNTP`.

foldername

  The name of the folder. If present, the `open` method is called with foldername as the argument.

options

  A hash where the following options may be the keys:

  `Content-Length`

    `Content-length` header is created or updated by `append_message` and `update_message`.

  `Create`

    If set, the folder is created if it doesn't already exist.

  `DefaultFolderType`

    Autodetects folder type if `create` option is set and `AUTODETECT` has been set.

  `DotLock`

    Uses .lock-style folder locking with the proper folder interface (currently used only with the mbox interface).

  `Flock`

    Uses flock-style folder locking with the proper folder interface (currently used only with the mbox interface).

  `NFSLock`

    Deals with NFS-style file locking with the proper folder interface and the NFS server in question.

  `notMUA`

    If set, makes updates but doesn't save message labels or the current message indicator. If not set (the default), saves labels and the current message indicator as appropriate for the folder interface.

  `Timeout`

    Overrides the default timeout value. Specified in seconds. Particularly useful for folder interfaces that involve network communications.

14.2 The Mail Modules |  | Reference: add_label