Top | ![]() |
![]() |
![]() |
![]() |
CamelIMAPXStatusResponse * | camel_imapx_status_response_new () |
const gchar * | camel_imapx_status_response_get_mailbox_name () |
gboolean | camel_imapx_status_response_get_messages () |
gboolean | camel_imapx_status_response_get_recent () |
gboolean | camel_imapx_status_response_get_unseen () |
gboolean | camel_imapx_status_response_get_uidnext () |
gboolean | camel_imapx_status_response_get_uidvalidity () |
gboolean | camel_imapx_status_response_get_highestmodseq () |
CamelIMAPXStatusResponse encapsulates an IMAP STATUS response, which describes the current status of a mailbox in terms of various message counts and change tracking indicators.
CamelIMAPXStatusResponse * camel_imapx_status_response_new (CamelIMAPXInputStream *stream
,gchar inbox_separator
,GCancellable *cancellable
,GError **error
);
Attempts to parse an IMAP STATUS response from stream
and, if successful,
stores the response data in a new CamelIMAPXStatusResponse. If an error
occurs, the function sets error
and returns NULL
.
stream |
||
inbox_separator |
the separator character for INBOX |
|
cancellable |
a GCancellable |
|
error |
return location for a GError, or |
Since: 3.10
const gchar *
camel_imapx_status_response_get_mailbox_name
(CamelIMAPXStatusResponse *response
);
Returns the mailbox name for response
.
Since: 3.10
gboolean camel_imapx_status_response_get_messages (CamelIMAPXStatusResponse *response
,guint32 *out_messages
);
If response
includes an updated "MESSAGES" value, write the value to
out_messages
and return TRUE
. Otherwise leave out_messages
unset
and return FALSE
.
The "MESSAGES" value refers to the number of messages in the mailbox.
The out_messages
argument can be NULL
, in which case the function
simply returns whether an updated "MESSAGES" value is present.
Since: 3.10
gboolean camel_imapx_status_response_get_recent (CamelIMAPXStatusResponse *response
,guint32 *out_recent
);
If response
includes an updated "RECENT" value, write the value to
out_recent
and return TRUE
. Otherwise leave out_recent
unset and
return FALSE
.
The "RECENT" value refers to the number of messages with the \Recent flag set.
The out_recent
argument can be NULL
, in which case the function
simply returns whether an updated "RECENT" value is present.
Since: 3.10
gboolean camel_imapx_status_response_get_unseen (CamelIMAPXStatusResponse *response
,guint32 *out_unseen
);
If response
includes an updated "UNSEEN" value, write the value to
out_unseen
and return TRUE
. Otherwise leave out_unseen
unset and
return FALSE
.
The "UNSEEN" value refers to the number of messages which do not have the \Seen flag set.
The out_unseen
argument can be NULL
, in which case the function
simply returns whether an updated "UNSEEN" value is present.
Since: 3.10
gboolean camel_imapx_status_response_get_uidnext (CamelIMAPXStatusResponse *response
,guint32 *out_uidnext
);
If response
includes an updated "UIDNEXT" value, write the value to
out_uidnext
and return TRUE
. Otherwise leave out_uidnext
unset and
return FALSE
.
The "UIDNEXT" value refers to the next unique identifier value of the mailbox.
The out_uidnext
argument can be NULL
, in which case the function
simply returns whether an updated "UIDNEXT" value is present.
Since: 3.10
gboolean camel_imapx_status_response_get_uidvalidity (CamelIMAPXStatusResponse *response
,guint32 *out_uidvalidity
);
If response
includes an updated "UIDVALIDITY" value, write the value to
out_uidvalidity
and return TRUE
. Otherwise leave out_uidvalidity
unset
and return FALSE
.
The "UIDVALIDITY" value refers to the unique identifier validity of the mailbox.
The out_uidvalidity
argument can be NULL
, in which case the function
simply returns whether an updated "UIDVALIDITY" value is present.
Since: 3.10
gboolean camel_imapx_status_response_get_highestmodseq (CamelIMAPXStatusResponse *response
,guint64 *out_highestmodseq
);
If response
includes an updated "HIGHESTMODSEQ" value, write the value to
out_highestmodseq
and return TRUE
. Otherwise leave out_highestmodseq
unset and return FALSE
.
The "HIGHESTMODSEQ" value refers to the the highest mod-sequence value of all messages in the mailbox, assuming the server supports the persistent storage of mod-sequences.
The out_highestmodseq
argument can be NULL
, in which case the function
simply returns whether an updated "HIGHESTMODSEQ" value is present.
Since: 3.10
struct CamelIMAPXStatusResponse;
Contains only private data that should be read and manipulated using the functions below.
Since: 3.10