---
name: "Mail::Box::Search::IMAP"
section: "3pm"
platform: "linux"
package: "libmail-box-perl"
version: "2.055-1"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/Mail::Box::Search::IMAP"
---

# Mail::Box::Search::IMAP(3pm)

Mail::Box::Search::IMAP - select messages within a IMAP folder

```
 Mail::Box::Search::IMAP
   is a Mail::Box::Search
   is a Mail::Reporter
```

```
 use Mail::Box::Manager;
 my $mgr    = Mail::Box::Manager->new;
 my $folder = $mgr->open('imap4:Inbox');
```

```
 my $filter = Mail::Box::Search::IMAP->new
    (  ...to be defined...
    );
```

```
 my @msgs   = $filter->search($folder);
 if($filter->search($message)) {...}
```

THIS PACKAGES IS NOT IMPLEMENTED YET: it waits for Mail::Transport::IMAP4 to be available.\
 **Constructors** Mail::Box::Search::IMAP-\>**new**(OPTIONS)

```
 Option      Defined in       Default
 binaries    L<Mail::Box::Search>  <false>
 decode      L<Mail::Box::Search>  <true>
 delayed     L<Mail::Box::Search>  <true>
 deleted     L<Mail::Box::Search>  <false>
 deliver     L<Mail::Box::Search>  undef
 in          L<Mail::Box::Search>  C<'BODY'>
 label       L<Mail::Box::Search>  undef
 limit       L<Mail::Box::Search>  C<0>
 log         L<Mail::Reporter>  C<'WARNINGS'>
 logical     L<Mail::Box::Search>  C<'REPLACE'>
 multiparts  L<Mail::Box::Search>  <true>
 trace       L<Mail::Reporter>  C<'WARNINGS'>
```

. binaries BOOLEAN

. decode BOOLEAN

. delayed BOOLEAN

. deleted BOOLEAN

. deliver undef⎪CODE⎪'DELETE'

. in 'HEAD'⎪'BODY'⎪'MESSAGE'

. label STRING

. limit NUMBER

. log LEVEL

. logical 'REPLACE'⎪'AND'⎪'OR'⎪'NOT'⎪'AND NOT'⎪'OR NOT'

. multiparts BOOLEAN

. trace LEVEL\
 **Searching** $obj-\>**inBody**(PART, BODY)

See "Searching" in Mail::Box::Search $obj-\>**inHead**(PART, HEAD)

See "Searching" in Mail::Box::Search $obj-\>**search**(FOLDER⎪THREAD⎪MESSAGE⎪ARRAY-OF-MESSAGES)

See "Searching" in Mail::Box::Search $obj-\>**searchPart**(PART)

See "Searching" in Mail::Box::Search\
 **The Results** $obj-\>**printMatch**(\[FILEHANDLE\], HASH)

See "The Results" in Mail::Box::Search\
 **Error handling** $obj-\>**AUTOLOAD**

See "Error handling" in Mail::Reporter $obj-\>**addReport**(OBJECT)

See "Error handling" in Mail::Reporter $obj-\>**defaultTrace**(\[LEVEL, \[LEVEL\]) Mail::Box::Search::IMAP-\>**defaultTrace**(\[LEVEL, \[LEVEL\])

See "Error handling" in Mail::Reporter $obj-\>**errors**

See "Error handling" in Mail::Reporter $obj-\>**log**(\[LEVEL \[,STRINGS\]\]) Mail::Box::Search::IMAP-\>**log**(\[LEVEL \[,STRINGS\]\])

See "Error handling" in Mail::Reporter $obj-\>**logPriority**(LEVEL) Mail::Box::Search::IMAP-\>**logPriority**(LEVEL)

See "Error handling" in Mail::Reporter $obj-\>**logSettings**

See "Error handling" in Mail::Reporter $obj-\>**notImplemented**

See "Error handling" in Mail::Reporter $obj-\>**report**(\[LEVEL\])

See "Error handling" in Mail::Reporter $obj-\>**reportAll**(\[LEVEL\])

See "Error handling" in Mail::Reporter $obj-\>**trace**(\[LEVEL\])

See "Error handling" in Mail::Reporter $obj-\>**warnings**

See "Error handling" in Mail::Reporter\
 **Cleanup** $obj-\>**DESTROY**

See "Cleanup" in Mail::Reporter $obj-\>**inGlobalDestruction**

See "Cleanup" in Mail::Reporter *Error:* Package `$package` does not implement `$method`. Fatal error: the specific package (or one of its superclasses) does not implement this method where it should. This message means that some other related classes do implement this method however the class at hand does not.  Probably you should investigate this and probably inform the author of the package. See the MailBox website at \<http://perl.overmeer.net/mailbox/\> for more details. Distribution version 2.055. Written by Mark Overmeer (mark@overmeer.net).  See the ChangeLog for other contributors. Copyright (c) 2001-2003 by the author(s). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.