imap_delete

imap_delete(IMAP\Connection $imap, string $message_nums, [int $flags]): true
```php

Marca los mensajes `message_nums` para el borrado. El borrado real no intervendrá hasta la llamada de la función `imap_expunge` o de `imap_close` con el parámetro opcional `CL_EXPUNGE`.

## Parámetros

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

`message_nums`  
Un string representando uno o varios mensajes en un estilo de formato de una secuencia IMAP4 (`"n"`, `"n:m"`, o una combinación de esto, delimitado por comas).

`flags`  
Puede ser definido a `FT_UID` que solicita a la función tratar el argumento `message_nums` como un `UID`.

## Valores devueltos

Retorna siempre `true`.

## Errores/Excepciones

Lanza una excepción `ValueError` si el parámetro `flags` 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 parámetro `flags` inválidos. Anteriormente, una advertencia era emitida y la función retornaba `false`. |

## Ejemplos

Ejemplo con `imap_delete`