NeoMutt  2022-04-29-249-gaae397
Teaching an old dog new tricks
mview.h File Reference

The "currently-open" mailbox. More...

#include <stdbool.h>
#include <sys/types.h>
+ Include dependency graph for mview.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  MailboxView
 The "current" mailbox. More...
struct  EventMview
 An Event that happened to an MailboxView. More...


 Types of MailboxView Event. More...


void mview_free (struct MailboxView **ptr)
 Free a MailboxView. More...
int mview_mailbox_observer (struct NotifyCallback *nc)
 Notification that a Mailbox has changed - Implements observer_t -. More...
struct MailboxViewmview_new (struct Mailbox *m)
 Create a new MailboxView. More...
void mview_update (struct MailboxView *mv)
 Update the MailboxView's message counts. More...
bool mview_has_limit (const struct MailboxView *mv)
 Is a limit active? More...
struct Mailboxmview_mailbox (struct MailboxView *mv)
 Wrapper to get the mailbox in a MailboxView, or NULL. More...
bool message_is_tagged (struct Email *e)
 Is a message in the index tagged (and within limit) More...
struct Emailmutt_get_virt_email (struct Mailbox *m, int vnum)
 Get a virtual Email. More...
int el_add_tagged (struct EmailList *el, struct MailboxView *mv, struct Email *e, bool use_tagged)
 Get a list of the tagged Emails. More...

Detailed Description

The "currently-open" mailbox.

  • Richard Russon

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Definition in file mview.h.

Enumeration Type Documentation

◆ NotifyMview

Types of MailboxView Event.

Observers of NT_MVIEW will be passed an EventMview.


The Mview has been opened.


The Mview is about to be destroyed.


The Mview has changed.

Definition at line 58 of file mview.h.

60 NT_MVIEW_ADD = 1,
The Mview is about to be destroyed.
Definition: mview.h:61
The Mview has changed.
Definition: mview.h:62
The Mview has been opened.
Definition: mview.h:60

Function Documentation

◆ mview_free()

void mview_free ( struct MailboxView **  ptr)

Free a MailboxView.

[out]ptrMailboxView to free

Definition at line 49 of file mview.c.

51 if (!ptr || !*ptr)
52 return;
54 struct MailboxView *mv = *ptr;
56 struct EventMview ev_m = { mv };
57 mutt_debug(LL_NOTIFY, "NT_MVIEW_DELETE: %p\n", mv);
60 if (mv->mailbox)
65 FREE(&mv->pattern);
68 FREE(&mv);
69 *ptr = NULL;
void mutt_pattern_free(struct PatternList **pat)
Free a Pattern.
Definition: compile.c:1038
#define mutt_debug(LEVEL,...)
Definition: logging.h:84
int mview_mailbox_observer(struct NotifyCallback *nc)
Notification that a Mailbox has changed - Implements observer_t -.
Definition: mview.c:313
Log of notifications.
Definition: logging.h:45
#define FREE(x)
Definition: memory.h:43
bool notify_observer_remove(struct Notify *notify, const observer_t callback, const void *global_data)
Remove an observer from an object.
Definition: notify.c:228
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:171
void notify_free(struct Notify **ptr)
Free a notification handler.
Definition: notify.c:73
void mutt_thread_ctx_free(struct ThreadsContext **tctx)
Finalize a threading context.
Definition: mutt_thread.c:365
MailboxView has changed, NotifyMview, EventMview.
Definition: notify_type.h:50
An Event that happened to an MailboxView.
Definition: mview.h:69
struct MailboxView * mv
The MailboxView this Event relates to.
Definition: mview.h:70
The "current" mailbox.
Definition: mview.h:38
struct Notify * notify
Notifications: NotifyMview, EventMview.
Definition: mview.h:50
struct PatternList * limit_pattern
Compiled limit pattern.
Definition: mview.h:41
struct ThreadsContext * threads
Threads context.
Definition: mview.h:42
struct Mailbox * mailbox
Current Mailbox.
Definition: mview.h:49
char * pattern
Limit pattern string.
Definition: mview.h:40
struct Notify * notify
Notifications: NotifyMailbox, EventMailbox.
Definition: mailbox.h:144
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mview_new()

struct MailboxView * mview_new ( struct Mailbox m)

Create a new MailboxView.

Return values
ptrNew MailboxView

Definition at line 77 of file mview.c.

79 if (!m)
80 return NULL;
82 struct MailboxView *mv = mutt_mem_calloc(1, sizeof(struct MailboxView));
84 mv->notify = notify_new();
86 struct EventMview ev_m = { mv };
87 mutt_debug(LL_NOTIFY, "NT_MVIEW_ADD: %p\n", mv);
89 // If the Mailbox is closed, mv->mailbox must be set to NULL
92 mv->mailbox = m;
94 mv->msg_in_pager = -1;
95 mv->collapsed = false;
98 return mv;
void * mutt_mem_calloc(size_t nmemb, size_t size)
Allocate zeroed memory on the heap.
Definition: memory.c:50
bool notify_observer_add(struct Notify *notify, enum NotifyType type, observer_t callback, void *global_data)
Add an observer to an object.
Definition: notify.c:189
struct Notify * notify_new(void)
Create a new notifications handler.
Definition: notify.c:60
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition: notify.c:93
struct ThreadsContext * mutt_thread_ctx_init(struct Mailbox *m)
Initialize a threading context.
Definition: mutt_thread.c:352
void mview_update(struct MailboxView *mv)
Update the MailboxView's message counts.
Definition: mview.c:125
Mailbox has changed, NotifyMailbox, EventMailbox.
Definition: notify_type.h:49
bool collapsed
Are all threads collapsed?
Definition: mview.h:47
int msg_in_pager
Message currently shown in the pager.
Definition: mview.h:43
Container for Accounts, Notifications.
Definition: neomutt.h:37
struct Notify * notify
Notifications handler.
Definition: neomutt.h:38
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mview_update()

void mview_update ( struct MailboxView mv)

Update the MailboxView's message counts.

mvMailbox View

this routine is called to update the counts in the MailboxView structure

Definition at line 125 of file mview.c.

127 if (!mv || !mv->mailbox)
128 return;
130 struct Mailbox *m = mv->mailbox;
135 /* reset counters */
136 m->msg_unread = 0;
137 m->msg_flagged = 0;
138 m->msg_new = 0;
139 m->msg_deleted = 0;
140 m->msg_tagged = 0;
141 m->vcount = 0;
142 m->changed = false;
146 const bool c_score = cs_subset_bool(NeoMutt->sub, "score");
147 struct Email *e = NULL;
148 for (int msgno = 0; msgno < m->msg_count; msgno++)
149 {
150 e = m->emails[msgno];
151 if (!e)
152 continue;
154 if (WithCrypto)
155 {
156 /* NOTE: this _must_ be done before the check for mailcap! */
157 e->security = crypt_query(e->body);
158 }
160 if (mview_has_limit(mv))
161 {
162 e->vnum = -1;
163 }
164 else
165 {
166 m->v2r[m->vcount] = msgno;
167 e->vnum = m->vcount++;
168 }
169 e->msgno = msgno;
171 if (e->env->supersedes)
172 {
173 struct Email *e2 = NULL;
175 if (!m->id_hash)
178 e2 = mutt_hash_find(m->id_hash, e->env->supersedes);
179 if (e2)
180 {
181 e2->superseded = true;
182 if (c_score)
183 mutt_score_message(mv->mailbox, e2, true);
184 }
185 }
187 /* add this message to the hash tables */
188 if (m->id_hash && e->env->message_id)
190 if (m->subj_hash && e->env->real_subj)
194 if (c_score)
195 mutt_score_message(mv->mailbox, e, false);
197 if (e->changed)
198 m->changed = true;
199 if (e->flagged)
200 m->msg_flagged++;
201 if (e->deleted)
202 m->msg_deleted++;
203 if (e->tagged)
204 m->msg_tagged++;
205 if (!e->read)
206 {
207 m->msg_unread++;
208 if (!e->old)
209 m->msg_new++;
210 }
211 }
213 /* rethread from scratch */
214 mutt_sort_headers(mv->mailbox, mv->threads, true, &mv->vsize);
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition: helpers.c:73
SecurityFlags crypt_query(struct Body *b)
Check out the type of encryption used.
Definition: crypt.c:675
struct HashElem * mutt_hash_insert(struct HashTable *table, const char *strkey, void *data)
Add a new element to the Hash Table (with string keys)
Definition: hash.c:335
void * mutt_hash_find(const struct HashTable *table, const char *strkey)
Find the HashElem data in a Hash Table element using a key.
Definition: hash.c:362
void mutt_hash_free(struct HashTable **ptr)
Free a hash table.
Definition: hash.c:457
void mutt_label_hash_add(struct Mailbox *m, struct Email *e)
Add a message's labels to the Hash Table.
Definition: mutt_header.c:383
void mutt_clear_threads(struct ThreadsContext *tctx)
Clear the threading of message in a mailbox.
Definition: mutt_thread.c:708
struct HashTable * mutt_make_id_hash(struct Mailbox *m)
Create a Hash Table for message-ids.
Definition: mutt_thread.c:1651
bool mview_has_limit(const struct MailboxView *mv)
Is a limit active?
Definition: mview.c:435
#define WithCrypto
Definition: lib.h:116
void mutt_score_message(struct Mailbox *m, struct Email *e, bool upd_mbox)
Apply scoring to an email.
Definition: score.c:159
void mutt_sort_headers(struct Mailbox *m, struct ThreadsContext *threads, bool init, off_t *vsize)
Sort emails by their headers.
Definition: sort.c:356
The envelope/body of an email.
Definition: email.h:37
bool read
Email is read.
Definition: email.h:48
struct Envelope * env
Envelope information.
Definition: email.h:66
SecurityFlags security
bit 0-10: flags, bit 11,12: application, bit 13: traditional pgp See: ncrypt/lib.h pgplib....
Definition: email.h:41
struct Body * body
List of MIME parts.
Definition: email.h:67
bool old
Email is seen, but unread.
Definition: email.h:47
bool changed
Email has been edited.
Definition: email.h:75
bool flagged
Marked important?
Definition: email.h:45
int vnum
Virtual message number.
Definition: email.h:114
int msgno
Number displayed to the user.
Definition: email.h:111
bool deleted
Email is deleted.
Definition: email.h:76
bool tagged
Email is tagged.
Definition: email.h:107
bool superseded
Got superseded?
Definition: email.h:50
char * supersedes
Supersedes header.
Definition: envelope.h:74
char * message_id
Message ID.
Definition: envelope.h:73
char * real_subj
Offset of the real subject.
Definition: envelope.h:71
off_t vsize
Size (in bytes) of the messages shown.
Definition: mview.h:39
A mailbox.
Definition: mailbox.h:79
int vcount
The number of virtual messages.
Definition: mailbox.h:99
bool changed
Mailbox has been modified.
Definition: mailbox.h:110
int * v2r
Mapping from virtual to real msgno.
Definition: mailbox.h:98
int msg_new
Number of new messages.
Definition: mailbox.h:92
int msg_count
Total number of messages.
Definition: mailbox.h:88
struct HashTable * subj_hash
Hash Table by subject.
Definition: mailbox.h:124
struct Email ** emails
Array of Emails.
Definition: mailbox.h:96
struct HashTable * id_hash
Hash Table by msg id.
Definition: mailbox.h:123
int msg_deleted
Number of deleted messages.
Definition: mailbox.h:93
int msg_flagged
Number of flagged messages.
Definition: mailbox.h:90
int msg_tagged
How many messages are tagged?
Definition: mailbox.h:94
int msg_unread
Number of unread messages.
Definition: mailbox.h:89
struct ConfigSubset * sub
Inherited config items.
Definition: neomutt.h:39
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mview_has_limit()

bool mview_has_limit ( const struct MailboxView mv)

Is a limit active?

Return values
trueA limit is active
falseNo limit is active

Definition at line 435 of file mview.c.

437 return mv && mv->pattern;
+ Here is the caller graph for this function:

◆ mview_mailbox()

struct Mailbox * mview_mailbox ( struct MailboxView mv)

Wrapper to get the mailbox in a MailboxView, or NULL.

Return values
ptrThe mailbox in the MailboxView
NULLMailboxView is NULL or doesn't have a mailbox

Definition at line 446 of file mview.c.

448 return mv ? mv->mailbox : NULL;
+ Here is the caller graph for this function:

◆ message_is_tagged()

bool message_is_tagged ( struct Email e)

Is a message in the index tagged (and within limit)

Return values
trueThe message is both tagged and within limit

If a limit is in effect, the message must be visible within it.

Definition at line 352 of file mview.c.

354 return e->visible && e->tagged;
bool visible
Is this message part of the view?
Definition: email.h:121
+ Here is the caller graph for this function:

◆ mutt_get_virt_email()

struct Email * mutt_get_virt_email ( struct Mailbox m,
int  vnum 

Get a virtual Email.

vnumVirtual index number
Return values
NULLNo Email selected, or bad index values

This safely gets the result of the following:

  • mailbox->emails[mailbox->v2r[vnum]]

Definition at line 414 of file mview.c.

416 if (!m || !m->emails || !m->v2r)
417 return NULL;
419 if ((vnum < 0) || (vnum >= m->vcount))
420 return NULL;
422 int inum = m->v2r[vnum];
423 if ((inum < 0) || (inum >= m->msg_count))
424 return NULL;
426 return m->emails[inum];
+ Here is the caller graph for this function:

◆ el_add_tagged()

int el_add_tagged ( struct EmailList *  el,
struct MailboxView mv,
struct Email e,
bool  use_tagged 

Get a list of the tagged Emails.

elEmpty EmailList to populate
mvCurrent Mailbox
eCurrent Email
use_taggedUse tagged Emails
Return values
numNumber of selected emails

Definition at line 366 of file mview.c.

368 int count = 0;
370 if (use_tagged)
371 {
372 if (!mv || !mv->mailbox || !mv->mailbox->emails)
373 return -1;
375 struct Mailbox *m = mv->mailbox;
376 for (int i = 0; i < m->msg_count; i++)
377 {
378 e = m->emails[i];
379 if (!e)
380 break;
381 if (!message_is_tagged(e))
382 continue;
384 struct EmailNode *en = mutt_mem_calloc(1, sizeof(*en));
385 en->email = e;
386 STAILQ_INSERT_TAIL(el, en, entries);
387 count++;
388 }
389 }
390 else
391 {
392 if (!e)
393 return -1;
395 struct EmailNode *en = mutt_mem_calloc(1, sizeof(*en));
396 en->email = e;
397 STAILQ_INSERT_TAIL(el, en, entries);
398 count = 1;
399 }
401 return count;
bool message_is_tagged(struct Email *e)
Is a message in the index tagged (and within limit)
Definition: mview.c:352
#define STAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:389
List of Emails.
Definition: email.h:132
struct Email * email
Email in the list.
Definition: email.h:133
+ Here is the call graph for this function:
+ Here is the caller graph for this function: