Debian Codegraph @

lib/common/font-manager-database-iterator.c

raw
1 /* font-manager-database-iterator.c
2 *
3 * Copyright (C) 2009-2024 Jerry Casiano
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.
17 *
18 * If not, see <http://www.gnu.org/licenses/gpl-3.0.txt>.
19 */
20
21 #include "font-manager-database-iterator.h"
22
23 /**
24 * SECTION: font-manager-database-iterator
25 * @short_description: Database iterator
26 * @title: Database
27 * @include: font-manager-database-iterator.h
28 *
29 * Make looping through database results more convenient
30 */
31
32 struct _FontManagerDatabaseIterator
33 {
34 GObjectClass parent_class;
35
36 FontManagerDatabase *db;
37 };
38
39 G_DEFINE_TYPE(FontManagerDatabaseIterator, font_manager_database_iterator, G_TYPE_OBJECT)
40
41 /**
42 * font_manager_database_iterator:
43 * @db: #FontManagerDatabase
44 *
45 * Returns: (transfer full): #FontManagerDatabaseIterator.
46 * Free the return object using g_object_unref().
47 */
48 FontManagerDatabaseIterator *
49 font_manager_database_iterator (FontManagerDatabase *db)
50 {
51 return font_manager_database_iterator_new(db);
52 }
53
54 static void
55 font_manager_database_iterator_dispose (GObject *gobject)
56 {
57 g_return_if_fail(gobject != NULL);
58 FontManagerDatabaseIterator *self = FONT_MANAGER_DATABASE_ITERATOR(gobject);
59 g_clear_object(&self->db);
60 G_OBJECT_CLASS(font_manager_database_iterator_parent_class)->dispose(gobject);
61 return;
62 }
63
64 static void
65 font_manager_database_iterator_class_init (FontManagerDatabaseIteratorClass *klass)
66 {
67 G_OBJECT_CLASS(klass)->dispose = font_manager_database_iterator_dispose;
68 return;
69 }
70
71 static void
72 font_manager_database_iterator_init (G_GNUC_UNUSED FontManagerDatabaseIterator *self)
73 {
74 return;
75 }
76
77 /**
78 * font_manager_database_iterator_next:
79 * @self: #FontManagerDatabase
80 *
81 * Returns: %TRUE if there are more results in set
82 */
83 gboolean
84 font_manager_database_iterator_next (FontManagerDatabaseIterator *self)
85 {
86 g_return_val_if_fail(self != NULL, FALSE);
87 g_return_val_if_fail(self->db != NULL, FALSE);
88 sqlite3_stmt *stmt = font_manager_database_get_cursor(self->db);
89 return (sqlite3_step(stmt) == SQLITE_ROW);
90 }
91
92 /**
93 * font_manager_database_iterator_get: (skip)
94 * @self: #FontManagerDatabase
95 *
96 * Returns: (transfer none): #sqlite3_stmt
97 */
98 sqlite3_stmt *
99 font_manager_database_iterator_get (FontManagerDatabaseIterator *self)
100 {
101 g_return_val_if_fail(self != NULL, NULL);
102 return font_manager_database_get_cursor(self->db);
103 }
104
105 /**
106 * font_manager_database_iterator_new:
107 * @db: #FontManagerDatabase
108 *
109 * Returns: (transfer full): A newly created #FontManagerDatabaseIterator.
110 * Free the returned object using g_object_unref().
111 */
112 FontManagerDatabaseIterator *
113 font_manager_database_iterator_new (FontManagerDatabase *db)
114 {
115 g_return_val_if_fail(db != NULL, NULL);
116 GObject *gobject = g_object_new(FONT_MANAGER_TYPE_DATABASE_ITERATOR, NULL);
117 FontManagerDatabaseIterator *self = FONT_MANAGER_DATABASE_ITERATOR(gobject);
118 self->db = g_object_ref(db);
119 return self;
120 }
121