imap_listscan(3) [php man page]

IMAP_LISTSCAN(3)							 1							  IMAP_LISTSCAN(3)

imap_listscan - Returns the list of mailboxes that matches the given text

SYNOPSIS

       array imap_listscan (resource  $imap_stream, string  $ref, string  $pattern, string  $content)

DESCRIPTION

	Returns an array containing the names of the mailboxes that have $content in the text of the mailbox.

	This function is similar to imap_listmailbox(3), but it will additionally check for the presence of the string $content inside the mailbox
       data.

PARAMETERS

	      o $
		imap_stream -An IMAP stream returned by imap_open(3).

	      o $ref
		-$ref should normally be just the server specification as described in imap_open(3)

	      o $pattern
		-Specifies where in the mailbox hierarchy to start searching.There are two special characters you can pass as part  of	the  $pat-
		tern:  '  *' and ' %'. ' *' means to return all mailboxes. If you pass $pattern as ' *', you will get a list of the entire mailbox
		hierarchy. ' %' means to return the current level only. ' %' as the $pattern parameter will return only the top level mailboxes; '
		~/mail/%' on UW_IMAPD will return every mailbox in the ~/mail directory, but none in subfolders of that directory.

	      o $content
		- The searched string

RETURN VALUES

	Returns an array containing the names of the mailboxes that have $content in the text of the mailbox.

SEE ALSO

       imap_listmailbox(3), imap_search(3).

PHP Documentation Group 													  IMAP_LISTSCAN(3)

IMAP_REOPEN(3)								 1							    IMAP_REOPEN(3)

imap_reopen - ReopenIMAPstream to new mailbox

SYNOPSIS

       bool imap_reopen (resource  $imap_stream, string  $mailbox, [int  $options], [int  $n_retries])

DESCRIPTION

	Reopens the specified stream to a new $mailbox on an IMAP or NNTP server.

PARAMETERS

	      o $
		imap_stream -An IMAP stream returned by imap_open(3).

	      o $mailbox
		- The mailbox name, see imap_open(3) for more information

	      o $options
		- The $options are a bit mask with one or more of the following:

		     o OP_READONLY - Open mailbox read-only

		     o OP_ANONYMOUS - Don't use or update a .newsrc for news (NNTP only)

		     o OP_HALFOPEN - For IMAP and NNTP names, open a connection but don't open a mailbox.

		     o OP_EXPUNGE - Silently expunge recycle stream

		     o CL_EXPUNGE - Expunge mailbox automatically upon mailbox close (see also imap_delete(3) and imap_expunge(3))

	      o $n_retries
		- Number of maximum connect attempts

RETURN VALUES

	Returns TRUE if the stream is reopened, FALSE otherwise.

CHANGELOG

       +--------+------------------+
       |Version |		   |
       |	|		   |
       |	|   Description    |
       |	|		   |
       +--------+------------------+
       | 5.2.0	|		   |
       |	|		   |
       |	| $n_retries added |
       |	|		   |
       +--------+------------------+
EXAMPLES

       Example #1

	      imap_reopen(3) example

	      <?php
	      $mbox = imap_open("{imap.example.org:143}INBOX", "username", "password") or die(implode(", ", imap_errors()));
	      // ...
	      imap_reopen($mbox, "{imap.example.org:143}INBOX.Sent") or die(implode(", ", imap_errors()));
	      // ..
	      ?>

PHP Documentation Group 													    IMAP_REOPEN(3)