Merge tag '0.31.4'
[notmuch] / bindings / ruby / messages.c
1 /* The Ruby interface to the notmuch mail library
2  *
3  * Copyright © 2010, 2011 Ali Polatel
4  *
5  * This program is free software: you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation, either version 3 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program.  If not, see https://www.gnu.org/licenses/ .
17  *
18  * Author: Ali Polatel <alip@exherbo.org>
19  */
20
21 #include "defs.h"
22
23 /*
24  * call-seq: MESSAGES.destroy! => nil
25  *
26  * Destroys the messages, freeing all resources allocated for it.
27  */
28 VALUE
29 notmuch_rb_messages_destroy (VALUE self)
30 {
31     notmuch_messages_t *messages;
32
33     Data_Get_Notmuch_Messages (self, messages);
34
35     notmuch_messages_destroy (messages);
36     DATA_PTR (self) = NULL;
37
38     return Qnil;
39 }
40
41 /* call-seq: MESSAGES.each {|item| block } => MESSAGES
42  *
43  * Calls +block+ once for each message in +self+, passing that element as a
44  * parameter.
45  */
46 VALUE
47 notmuch_rb_messages_each (VALUE self)
48 {
49     notmuch_message_t *message;
50     notmuch_messages_t *messages;
51
52     Data_Get_Notmuch_Messages (self, messages);
53
54     for (; notmuch_messages_valid (messages); notmuch_messages_move_to_next (messages)) {
55         message = notmuch_messages_get (messages);
56         rb_yield (Data_Wrap_Struct (notmuch_rb_cMessage, NULL, NULL, message));
57     }
58
59     return self;
60 }
61
62 /*
63  * call-seq: MESSAGES.tags => TAGS
64  *
65  * Collect tags from the messages
66  */
67 VALUE
68 notmuch_rb_messages_collect_tags (VALUE self)
69 {
70     notmuch_tags_t *tags;
71     notmuch_messages_t *messages;
72
73     Data_Get_Notmuch_Messages (self, messages);
74
75     tags = notmuch_messages_collect_tags (messages);
76     if (!tags)
77         rb_raise (notmuch_rb_eMemoryError, "Out of memory");
78
79     return Data_Wrap_Struct (notmuch_rb_cTags, NULL, NULL, tags);
80 }