Name
new
Synopsis
$folder= new(ftype[,foldername][,options])
Creates a new Mail::Folder object of the specified type. Arguments are:
ftypeThe type of folder. Possible values are
mbox,maildir,emaul, orNNTP.foldernameThe name of the folder. If present, the
openmethod is called withfoldernameas the argument.optionsA hash in which the following options may be the keys:
Content-LengthContent-lengthheader is created or updated byappend_messageandupdate_message.CreateIf set, the folder is created if it doesn’t already exist.
DefaultFolderTypeAutodetects folder type if
createoption is set andAUTODETECThas been set.DotLockUses .lock-style folder locking with the proper folder interface (currently used only with the mbox interface).
FlockUses
flock-style folder locking with the proper folder interface (currently used only with the mbox interface).NFSLockDeals with NFS-style file locking with the proper folder interface and the NFS server in question.
notMUAIf 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.
TimeoutOverrides the default timeout value. Specified in seconds. Particularly useful for folder interfaces that involve network communications.