(PHP 4, PHP 5)
imap_clearflag_full — Clears flags on messages
$imap_stream
, string $sequence
, string $flag
[, int $options
= 0
] )
This function causes a store to delete the specified
flag
to the flags set for the
messages in the specified sequence
.
imap_stream
由 imap_open() 返回的 IMAP 流。
sequence
A sequence of message numbers. You can enumerate desired messages with the X,Y syntax, or retrieve all messages within an interval with the X:Y syntax
flag
The flags which you can unset are "\\Seen", "\\Answered", "\\Flagged", "\\Deleted", and "\\Draft" (as defined by » RFC2060)
options
options
are a bit mask and may contain
the single option:
ST_UID
- The sequence argument contains UIDs
instead of sequence numbers
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
Nohado (2010-08-26 07:41:01)
I got a note that:
if u want to set a mail to "//Unseen", which not exists,
do it like this:
imap_clearflag_full($your_imap_connection,
$number_of_message,"//Seen");
but, remember to do
imap_close($imap, CL_EXPUNGE);
@ the END! so that it will be confirmed!
Cheers,
Nohado
Mark Hill (2009-07-30 03:36:14)
Remember to specify your flags like '\\Seen' rather than "\\Seen".
Of course, flags are an IMAP feature, not a POP feature.
Resetting \\Seen works from PHP 4.3 works fine on the modern mail servers I've tested.
(2005-11-21 09:42:32)
imap_clearflag_full() and imap_setflag_full() seem to only change messageflags permanently with IMAP connections, not with POP3 connections.
calmdown at abendstille dot at (2003-01-16 17:23:25)
This function seems not to save the \\Seen flag permanently.
Testet on Win NT IIS 4.0 PHP 4.3 and imap-mail-server