imap_setflag_full

imap_setflag_full(IMAP\Connection $imap, string $sequence, string $flag, [int $options]): true
```php

`imap_setflag_full` asigna el `flag` especificado a los mensajes de la `sequence` dada.

## Parámetros

`imap`  
Una instancia de `IMAP\Connection`.

`sequence`  
Una secuencia de números de mensajes. Los mensajes deseados pueden ser enumerados con la sintaxis `X,Y`, o recuperar todos los mensajes de un intervalo con la sintaxis `X:Y`

`flag`  
Los flags que pueden ser modificados son `\Seen`, `\Answered`, `\Flagged`, `\Deleted`, y `\Draft` (como se define en la [RFC2060](https://datatracker.ietf.org/doc/html/rfc2060)).

`options`  
`options` es una máscara de bits, que acepta únicamente el siguiente valor:

- `ST_UID` - la secuencia contiene UID en lugar de números de secuencia.

## Valores devueltos

Retorna siempre `true`.

## Errores/Excepciones

Lanza una excepción `ValueError` si el argumento `options` es inválido.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `imap` ahora espera una instancia de `IMAP\Connection` ; anteriormente, se esperaba un `resource` `imap` válido. |
| 8.0.0 | Una excepción `ValueError` es ahora lanzada para valores de argumento `options` inválidos. Anteriormente, se emitía una advertencia y la función devolvía `false`. |

## Ejemplos

Ejemplo con `imap_setflag_full`