Merge tag '0.31.4'
[notmuch] / bindings / ruby / tags.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: TAGS.destroy! => nil
25  *
26  * Destroys the tags, freeing all resources allocated for it.
27  */
28 VALUE
29 notmuch_rb_tags_destroy (VALUE self)
30 {
31     notmuch_tags_t *tags;
32
33     Data_Get_Notmuch_Tags (self, tags);
34
35     notmuch_tags_destroy (tags);
36     DATA_PTR (self) = NULL;
37
38     return Qnil;
39 }
40
41 /*
42  * call-seq: TAGS.each {|item| block } => TAGS
43  *
44  * Calls +block+ once for each element in +self+, passing that element as a
45  * parameter.
46  */
47 VALUE
48 notmuch_rb_tags_each (VALUE self)
49 {
50     const char *tag;
51     notmuch_tags_t *tags;
52
53     Data_Get_Notmuch_Tags (self, tags);
54
55     for (; notmuch_tags_valid (tags); notmuch_tags_move_to_next (tags)) {
56         tag = notmuch_tags_get (tags);
57         rb_yield (rb_str_new2 (tag));
58     }
59
60     return self;
61 }