(PHP 4, PHP 5, PHP 7)
imap_mail_copy — Copy specified messages to a mailbox
$imap_stream
   , string $msglist
   , string $mailbox
   [, int $options = 0
  ] )
   Copies mail messages specified by msglist
   to specified mailbox.
  
imap_streamAn IMAP stream returned by imap_open().
msglist
       msglist is a range not just message
       numbers (as described in » RFC2060).
      
mailboxThe mailbox name, see imap_open() for more information
options
       options is a bitmask of one or more of
       
CP_UID - the sequence numbers contain UIDS
         
        CP_MOVE - Delete the messages from
          the current mailbox after copying
         
        
   Returns TRUE on success or FALSE on failure.