imap_clearflag_full

(PHP 4, PHP 5)

imap_clearflag_full — メッセージのフラグをクリアする

説明

bool imap_clearflag_full ( resource $imap_stream , string $sequence , string $flag [, int $options = 0 ] )

この関数は、指定したシーケンス sequence のメッセージのフラグから、指定したフラグ flag を削除します。

パラメータ

imap_stream

imap_open() が返す IMAP ストリーム。

sequence

メッセージ番号のシーケンス。 X,Y のようにメッセージを列挙したり、 X:Y のようにしてその間のすべてのメッセージを指定したりできます。

flag

設定可能なフラグは "\\Seen"、 "\\Answered"、"\\Flagged"、"\\Deleted" および "\\Draft" です (» RFC2060 で定義されています)。

options

オプション options はビットマスクであり、以下の組み合わせとなります。

ST_UID - シーケンス引数はシーケンス番号の代わりに UID を含みます。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

参考

imap_setflag_full() - メッセージにフラグをセットする

imap_close

imap_check

[edit] Last updated: Fri, 11 Nov 2011

add a note User Contributed Notes imap_clearflag_full

Nohado 27-Aug-2010 12:11


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 08:06


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.

22-Nov-2005 04:12


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 11:53


This function seems not to save the \\Seen flag permanently.



Testet on Win NT IIS 4.0 PHP 4.3 and imap-mail-server

add a note