php man page for imap_mail_copy

IMAP_MAIL_COPY(3)							 1							 IMAP_MAIL_COPY(3)

imap_mail_copy - Copy specified messages to a mailbox

SYNOPSIS
       bool imap_mail_copy (resource  $imap_stream, string  $msglist, string  $mailbox, [int  $options])

DESCRIPTION
	Copies mail messages specified by $msglist to specified mailbox.

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

	      o $msglist
		-$msglist is a range not just message numbers (as described in RFC2060).

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

	      o $options
		-$options is a bitmask of one or more of

		     o CP_UID - the sequence numbers contain UIDS

		     o CP_MOVE - Delete the messages from the current mailbox after copying

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

SEE ALSO
       imap_mail_move(3).

PHP Documentation Group 													 IMAP_MAIL_COPY(3)