OVERLOADED

overload: ""
See "" in Mail::Box.
overload: @{}
See @{} in Mail::Box.
overload: cmp
See cmp in Mail::Box.

METHODS

See METHODS in Mail::Reporter

Constructors

$class->new( %options )
Option Defined in Default

access

Mail::Box

always 'r'

body_delayed_type

Mail::Box

Mail::Message::Body::Delayed

body_type

Mail::Box::File

<see description>

coerce_options

Mail::Box

[]

create

Mail::Box

not implemented

extract

Mail::Box

10240

field_type

Mail::Box

undef

fix_headers

Mail::Box

<false>

folder

Mail::Box

=Folders.dbx

folderdir

Mail::Box

.

head_delayed_type

Mail::Box

Mail::Message::Head::Delayed

head_type

Mail::Box

Mail::Message::Head::Complete

keep_dups

Mail::Box

<false>

lock_extension

Mail::Box::File

'.lock'

lock_file

Mail::Box

<foldername><lock-extension>

lock_timeout

Mail::Box

1 hour

lock_type

Mail::Box

'NONE'

lock_wait

Mail::Box

10 seconds

locker

Mail::Box

undef

log

Mail::Reporter

'WARNINGS'

manager

Mail::Box

undef

message_type

Mail::Box

Mail::Box::Dbx::Message

multipart_type

Mail::Box

Mail::Message::Body::Multipart

remove_when_empty

Mail::Box

not implemented

save_on_exit

Mail::Box

not implemented

trace

Mail::Reporter

'WARNINGS'

trusted

Mail::Box

<depends on folder location>

write_policy

Mail::Box::File

not implemented

access => MODE
body_delayed_type => CLASS
body_type => CLASS|CODE
coerce_options => ARRAY
create => BOOLEAN
extract => INTEGER | CODE | METHOD | 'LAZY'|'ALWAYS'
field_type => CLASS
fix_headers => BOOLEAN
folder => FOLDERNAME
folderdir => DIRECTORY
head_delayed_type => CLASS
head_type => CLASS
keep_dups => BOOLEAN
lock_extension => FILENAME|STRING
lock_file => FILENAME
lock_timeout => SECONDS
lock_type => CLASS|STRING|ARRAY
lock_wait => SECONDS
locker => OBJECT
log => LEVEL
manager => MANAGER
message_type => CLASS
multipart_type => CLASS
remove_when_empty => BOOLEAN
save_on_exit => BOOLEAN
trace => LEVEL
trusted => BOOLEAN
write_policy => 'REPLACE'|'INPLACE'|undef
» Warning: Dbx folders are read-only.

The folder

$obj->addMessage( $message, %options )
See addMessage in Mail::Box.
$obj->addMessages( @messages )
See addMessages in Mail::Box.
$class->appendMessages( %options )
See appendMessages in Mail::Box::File.
$obj->close( %options )
See close in Mail::Box.
$obj->copyTo( $folder, %options )
See copyTo in Mail::Box.
$obj->delete( %options )
See delete in Mail::Box.
$obj->filename
See filename in Mail::Box::File.
$obj->folderdir( [$directory] )
See folderdir in Mail::Box.
$obj->name
See name in Mail::Box.
$obj->organization
See organization in Mail::Box.
$obj->size
See size in Mail::Box.
$obj->type
See type in Mail::Box.
$obj->update( %options )
See update in Mail::Box.
$obj->url
See url in Mail::Box.

Folder flags

$obj->access
See access in Mail::Box.
$obj->isModified
See isModified in Mail::Box.
$obj->modified( [BOOLEAN] )
See modified in Mail::Box.
$obj->writable
See writable in Mail::Box.

The messages

$obj->current( [$number|$message|$message_id] )
See current in Mail::Box.
$obj->find( $message_id )
See find in Mail::Box.
$obj->findFirstLabeled( $label, [BOOLEAN, [$msgs]] )
See findFirstLabeled in Mail::Box.
$obj->message( $index, [$message] )
See message in Mail::Box.
$obj->messageId( $message_id, [$message] )
See messageId in Mail::Box.
$obj->messageIds
See messageIds in Mail::Box.
$obj->messages( <'ALL'|$range|'ACTIVE'|'DELETED'|$label| !$label|$filter> )
See messages in Mail::Box.
$obj->nrMessages( %options )
See nrMessages in Mail::Box.
$obj->scanForMessages( $message, $message_ids, $timespan, $window )
See scanForMessages in Mail::Box.

Sub-folders

$obj->listSubFolders( %options )
$class->listSubFolders( %options )

It is advised to set the check flag, because dbx folder often list large amounts of folder names which do not really exist. However, checking does consume some time.

Option Defined in Default

check

Mail::Box

<false>

folder

Mail::Box

<from calling object>

folderdir

Mail::Box

<from folder>

skip_empty

Mail::Box

<false>

check => BOOLEAN
folder => FOLDERNAME
folderdir => DIRECTORY
skip_empty => BOOL
$obj->nameOfSubFolder( $subname, [$parentname] )
$class->nameOfSubFolder( $subname, [$parentname] )
See nameOfSubFolder in Mail::Box.
$obj->openRelatedFolder( %options )
See openRelatedFolder in Mail::Box.
$obj->openSubFolder( $subname, %options )
See openSubFolder in Mail::Box.
$obj->topFolderWithMessages
$class->topFolderWithMessages
See topFolderWithMessages in Mail::Box.

Internals

$obj->coerce( $message, %options )
See coerce in Mail::Box.
$obj->create( $foldername, %options )
$class->create( $foldername, %options )

Creation is not supported for dbx folders.

Option Defined in Default

folderdir

Mail::Box

undef

folderdir => DIRECTORY
$obj->determineBodyType( $message, $head )
See determineBodyType in Mail::Box.
$obj->folderToFilename( $foldername, $folderdir )
$class->folderToFilename( $foldername, $folderdir )

Translate a folder name into a filename, using the $folderdir value to replace a leading =.

$class->foundIn( [$foldername], %options )

If no $foldername is specified, then the value of the folder option is taken. A dbx folder is a file which name ends on .dbx (case insensitive).

Option Defined in Default

folder

undef

folderdir

Mail::Box

undef

folder => FOLDERNAME
folderdir => DIRECTORY
$obj->lineSeparator( [<STRING|'CR'|'LF'|'CRLF'>] )
See lineSeparator in Mail::Box.
$obj->locker
See locker in Mail::Box.
$obj->messageCreateOptions( [$type, $config] )
See messageCreateOptions in Mail::Box::File.
$obj->moveAwaySubFolder( $directory, $extension )
See moveAwaySubFolder in Mail::Box::File.
$obj->parser

The parsing of messages is a combined job for the Mail::Transport::Dbx module (to get the right data) and read(). Asking for the parser will provide the transporter object. If asked more than once, each time the same object will be returned.

» Error: Cannot read dbx folder file $filename.
$obj->read( %options )
See read in Mail::Box.
$obj->readMessages( %options )
See readMessages in Mail::Box.
$obj->storeMessage( $message )
See storeMessage in Mail::Box.
$obj->toBeThreaded( $messages )
See toBeThreaded in Mail::Box.
$obj->toBeUnthreaded( $messages )
See toBeUnthreaded in Mail::Box.
$obj->updateMessages( %options )
See updateMessages in Mail::Box::File.
$obj->write( %options )
See write in Mail::Box::File.
$obj->writeMessages( %options )
See writeMessages in Mail::Box.

Other methods

$obj->timespan2seconds( $time )
$class->timespan2seconds( $time )
See timespan2seconds in Mail::Box.

Error handling

$obj->AUTOLOAD
See AUTOLOAD in Mail::Reporter.
$obj->addReport( $object )
See addReport in Mail::Reporter.
$obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )
$class->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )
See defaultTrace in Mail::Reporter.
$obj->errors
See errors in Mail::Reporter.
$obj->log( [$level, [$strings]] )
$class->log( [$level, [$strings]] )
See log in Mail::Reporter.
$obj->logPriority( $level )
$class->logPriority( $level )
See logPriority in Mail::Reporter.
$obj->logSettings
See logSettings in Mail::Reporter.
$obj->notImplemented
See notImplemented in Mail::Reporter.
$obj->report( [$level] )
See report in Mail::Reporter.
$obj->reportAll( [$level] )
See reportAll in Mail::Reporter.
$obj->trace( [$level] )
See trace in Mail::Reporter.
$obj->warnings
See warnings in Mail::Reporter.

Cleanup

$obj->DESTROY
See DESTROY in Mail::Box.

DETAILS

File based folders

See File based folders in Mail::Box::File