delete-letter

Arguments: mailbox messages &key expunge uid

When mailbox is a connection to an imap server

When using an imap server, mailbox is the mailbox object returned by make-imap-connection. This function marks the messages for deletion and then removes them permanently (using expunge-mailbox) if expunge is true. expunge defaults to true. If uid is true then the message numbers are unique ids instead of message sequence numbers.

When mailbox is a connection to a pop server

When using a pop server, only the mailbox and messages arguments are used. This function marks the specified messages for deletion. mailbox is the mailbox object returned by make-pop-connection. The messages are only marked for deletion. They are not removed until a close-connection is done. If the connection to the pop server is broken before a close-connection is done, the messages will not be deleted and they will no longer be marked for deletion either.

messages can either be a message number, a list of the form (:seq N M) meaning messages N through M or it can be a list of message numbers and/or :seq specifiers. The messages in a mailbox are numbered starting with one. Marking a message for deletion does not affect the numbering of other messages in the mailbox.

See imap.htm for more information.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.