imap_clearflag_full

(PHP 4, PHP 5)

imap_clearflag_full — Clears flags on messages

说明

bool imap_clearflag_full ( resource $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.

参见

imap_setflag_full() - Sets flags on messages

PHP手册 - N: Clears flags on messages

用户评论:

Nohado (26-Aug-2010 03:41)

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 (30-Jul-2009 11:36)

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.

(21-Nov-2005 05:42)

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 (17-Jan-2003 01:23)

This function seems not to save the \\Seen flag permanently. Testet on Win NT IIS 4.0 PHP 4.3 and imap-mail-server