File: messages.go

package info (click to toggle)
golang-github-zenhack-go.notmuch 0.0~git20190821.5a19619-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid, trixie
  • size: 240 kB
  • sloc: makefile: 22
file content (74 lines) | stat: -rw-r--r-- 2,026 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
package notmuch

// Copyright © 2015 The go.notmuch Authors. Authors can be found in the AUTHORS file.
// Licensed under the GPLv3 or later.
// See COPYING at the root of the repository for details.

// #cgo LDFLAGS: -lnotmuch
// #include <stdlib.h>
// #include <notmuch.h>
import "C"
import (
	"unsafe"
)

// Messages represents notmuch messages.
type Messages cStruct

func (ms *Messages) Close() error {
	return (*cStruct)(ms).doClose(func() error {
		C.notmuch_messages_destroy(ms.toC())
		return nil
	})
}

func (ms *Messages) toC() *C.notmuch_messages_t {
	return (*C.notmuch_messages_t)(ms.cptr)
}

// Next retrieves the next message from the result set. Next returns true if a message
// was successfully retrieved.
func (ms *Messages) Next(m **Message) bool {
	if !ms.valid() {
		return false
	}
	*m = ms.get()
	C.notmuch_messages_move_to_next(ms.toC())
	return true
}

// Tags return a list of tags from all messages.
//
// WARNING: You can no longer iterate over messages after calling this
// function, because the iterator will point at the end of the list.  We do not
// have a function to reset the iterator yet and the only way how you can
// iterate over the list again is to recreate the message list.
func (ms *Messages) Tags() *Tags {
	ctags := C.notmuch_messages_collect_tags(ms.toC())
	// TODO(kalbasit): notmuch_messages_collect_tags can return NULL on error
	// but there's not explanation on what kind of error can occur. We should handle
	// it as OOM for now but we eventually have to narrow it down.
	checkOOM(unsafe.Pointer(ctags))
	tags := &Tags{
		cptr:   unsafe.Pointer(ctags),
		parent: (*cStruct)(ms),
	}
	setGcClose(tags)
	return tags
}

func (ms *Messages) get() *Message {
	cmessage := C.notmuch_messages_get(ms.toC())
	checkOOM(unsafe.Pointer(cmessage))
	message := &Message{
		cptr:   unsafe.Pointer(cmessage),
		parent: (*cStruct)(ms),
	}
	setGcClose(message)
	return message
}

func (ms *Messages) valid() bool {
	cbool := C.notmuch_messages_valid(ms.toC())
	return int(cbool) != 0
}