notmuch_database_find_message

Find a message with the given message_id.

If a message with the given message_id is found then, on successful return (NOTMUCH_STATUS_SUCCESS) '*message' will be initialized to a message object. The caller should call notmuch_message_destroy when done with the message.

On any failure or when the message is not found, this function initializes '*message' to NULL. This means, when NOTMUCH_STATUS_SUCCESS is returned, the caller is supposed to check '*message' for NULL to find out whether the message with the given message_id was found.

Return value:

version(DerelictNotMuch_Static)nothrow
notmuch_database_find_message
(
,
const(char)* message_id
,
notmuch_message_t** message
)

Detailed Description

NOTMUCH STATUS SUCCESS

Successful return, check '*message'.

NOTMUCH STATUS NULL POINTER

The given 'message' argument is NULL

NOTMUCH STATUS OUT OF MEMORY

Out of memory, creating message object

NOTMUCH STATUS XAPIAN EXCEPTION

A Xapian exception occurred

Meta