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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/* mapiterator.c generated by valac 0.18.0, the Vala compiler
* generated from mapiterator.vala, do not modify */
/* mapiterator.vala
*
* Copyright (C) 2009 Didier Villevalois
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
* This library 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
* Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
* Author:
* Didier 'Ptitjes Villevalois <ptitjes@free.fr>
*/
#include <glib.h>
#include <glib-object.h>
#define GEE_TYPE_MAP_ITERATOR (gee_map_iterator_get_type ())
#define GEE_MAP_ITERATOR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GEE_TYPE_MAP_ITERATOR, GeeMapIterator))
#define GEE_IS_MAP_ITERATOR(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GEE_TYPE_MAP_ITERATOR))
#define GEE_MAP_ITERATOR_GET_INTERFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GEE_TYPE_MAP_ITERATOR, GeeMapIteratorIface))
typedef struct _GeeMapIterator GeeMapIterator;
typedef struct _GeeMapIteratorIface GeeMapIteratorIface;
struct _GeeMapIteratorIface {
GTypeInterface parent_iface;
gboolean (*next) (GeeMapIterator* self);
gboolean (*has_next) (GeeMapIterator* self);
gboolean (*first) (GeeMapIterator* self);
gpointer (*get_key) (GeeMapIterator* self);
gpointer (*get_value) (GeeMapIterator* self);
void (*set_value) (GeeMapIterator* self, gconstpointer value);
void (*unset) (GeeMapIterator* self);
};
GType gee_map_iterator_get_type (void) G_GNUC_CONST;
gboolean gee_map_iterator_next (GeeMapIterator* self);
gboolean gee_map_iterator_has_next (GeeMapIterator* self);
gboolean gee_map_iterator_first (GeeMapIterator* self);
gpointer gee_map_iterator_get_key (GeeMapIterator* self);
gpointer gee_map_iterator_get_value (GeeMapIterator* self);
void gee_map_iterator_set_value (GeeMapIterator* self, gconstpointer value);
void gee_map_iterator_unset (GeeMapIterator* self);
/**
* Advances to the next entry in the iteration.
*
* @return ``true`` if the iterator has a next entry
*/
gboolean gee_map_iterator_next (GeeMapIterator* self) {
g_return_val_if_fail (self != NULL, FALSE);
return GEE_MAP_ITERATOR_GET_INTERFACE (self)->next (self);
}
/**
* Checks whether there is a next entry in the iteration.
*
* @return ``true`` if the iterator has a next entry
*/
gboolean gee_map_iterator_has_next (GeeMapIterator* self) {
g_return_val_if_fail (self != NULL, FALSE);
return GEE_MAP_ITERATOR_GET_INTERFACE (self)->has_next (self);
}
/**
* Rewinds to the first entry in the iteration.
*
* @return ``true`` if the iterator has a first entry
*/
gboolean gee_map_iterator_first (GeeMapIterator* self) {
g_return_val_if_fail (self != NULL, FALSE);
return GEE_MAP_ITERATOR_GET_INTERFACE (self)->first (self);
}
/**
* Returns the current key in the iteration.
*
* @return the current key in the iteration
*/
gpointer gee_map_iterator_get_key (GeeMapIterator* self) {
g_return_val_if_fail (self != NULL, NULL);
return GEE_MAP_ITERATOR_GET_INTERFACE (self)->get_key (self);
}
/**
* Returns the value associated with the current key in the iteration.
*
* @return the value for the current key
*/
gpointer gee_map_iterator_get_value (GeeMapIterator* self) {
g_return_val_if_fail (self != NULL, NULL);
return GEE_MAP_ITERATOR_GET_INTERFACE (self)->get_value (self);
}
/**
* Sets the value associated with the current key in the iteration.
*
* @param value the new value for the current key
*/
void gee_map_iterator_set_value (GeeMapIterator* self, gconstpointer value) {
g_return_if_fail (self != NULL);
GEE_MAP_ITERATOR_GET_INTERFACE (self)->set_value (self, value);
}
/**
* Unsets the current entry in the iteration. The cursor is set in an
* in-between state. {@link get_key}, {@link get_value}, {@link set_value}
* and {@link unset} will fail until the next move of the cursor (calling
* {@link next} or {@link first}).
*/
void gee_map_iterator_unset (GeeMapIterator* self) {
g_return_if_fail (self != NULL);
GEE_MAP_ITERATOR_GET_INTERFACE (self)->unset (self);
}
static void gee_map_iterator_base_init (GeeMapIteratorIface * iface) {
static gboolean initialized = FALSE;
if (!initialized) {
initialized = TRUE;
}
}
/**
* An iterator over a map.
*
* Gee's iterators are "on-track" iterators. They always point to an item
* except before the first call to {@link next} or {@link first}, or, when an
* item has been removed, until the next call to {@link next} or {@link first}.
*
* Please note that when the iterator is out of track, neither {@link get_key},
* {@link get_value}, {@link set_value} nor {@link unset} are defined and all
* will fail. After the next call to {@link next} or {@link first}, they will
* be defined again.
*/
GType gee_map_iterator_get_type (void) {
static volatile gsize gee_map_iterator_type_id__volatile = 0;
if (g_once_init_enter (&gee_map_iterator_type_id__volatile)) {
static const GTypeInfo g_define_type_info = { sizeof (GeeMapIteratorIface), (GBaseInitFunc) gee_map_iterator_base_init, (GBaseFinalizeFunc) NULL, (GClassInitFunc) NULL, (GClassFinalizeFunc) NULL, NULL, 0, 0, (GInstanceInitFunc) NULL, NULL };
GType gee_map_iterator_type_id;
gee_map_iterator_type_id = g_type_register_static (G_TYPE_INTERFACE, "GeeMapIterator", &g_define_type_info, 0);
g_type_interface_add_prerequisite (gee_map_iterator_type_id, G_TYPE_OBJECT);
g_once_init_leave (&gee_map_iterator_type_id__volatile, gee_map_iterator_type_id);
}
return gee_map_iterator_type_id__volatile;
}
|
