(PHP 4, PHP 5, PHP 7, PHP 8)
imap_setflag_full — Define sinalizadores em mensagens
Faz com que um armazenamento adicione o sinalizador flag
especificado ao
conjunto de sinalizadores para as mensagens na
sequência informada em sequence
.
imap
Uma instância de IMAP\Connection.
sequence
Uma sequência de números de mensagens. Pode-se enumerar mensagens desejadas
com a sintaxe X,Y
ou recuperar todas as mensagens
dentro de um intervalo com a sintaxe X:Y
flag
Os sinalizadores que podem ser definir são \Seen
,
\Answered
, \Flagged
,
\Deleted
e \Draft
conforme
definido pela » RFC2060.
options
Uma máscara de bits que pode conter a única opção:
ST_UID
- O argumento de sequência contém UIDs
em vez de números de sequência
Sempre retorna true
.
Lança um ValueError se options
for inválido.
Versão | Descrição |
---|---|
8.1.0 |
O parâmetro imap agora espera uma instância de IMAP\Connection;
anteriormente, um resource imap válido era esperado.
|
8.0.0 |
Um ValueError agora é lançado em valores de parâmetro
options inválidos. Anteriormente,
um aviso era emitido e a função retornava false .
|
Exemplo #1 Exemplo de imap_setflag_full()
<?php
$mbox = imap_open("{imap.example.org:143}", "username", "password")
or die("Não foi possível conectar: " . imap_last_error());
$status = imap_setflag_full($mbox, "2,5", "\\Seen \\Flagged");
echo gettype($status) . "\n";
echo $status . "\n";
imap_close($mbox);
?>