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
|
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/* eel-glib-extensions.h - interface for new functions that conceptually
belong in glib. Perhaps some of these will be
actually rolled into glib someday.
Copyright (C) 2000 Eazel, Inc.
The Mate Library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
The Mate 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with the Mate Library; see the file COPYING.LIB. If not,
write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301, USA.
Authors: John Sullivan <sullivan@eazel.com>
*/
#ifndef EEL_GLIB_EXTENSIONS_H
#define EEL_GLIB_EXTENSIONS_H
#include <glib.h>
#include <gio/gio.h>
/* A gboolean variant for bit fields. */
typedef guint eel_boolean_bit;
/* Callback functions that have user data. */
typedef int (* EelCompareFunction) (gconstpointer a,
gconstpointer b,
gpointer callback_data);
typedef int (* EelSearchFunction) (gconstpointer item,
gpointer callback_data);
/* Predicate. */
typedef gboolean (* EelPredicateFunction) (gpointer data,
gpointer callback_data);
/* Date & time functions. */
GDate * eel_g_date_new_tm (struct tm *time_pieces);
char * eel_strdup_strftime (const char *format,
struct tm *time_pieces);
/* GList functions. */
gboolean eel_g_list_exactly_one_item (GList *list);
gboolean eel_g_list_more_than_one_item (GList *list);
gboolean eel_g_list_equal (GList *list_a,
GList *list_b);
gboolean eel_g_lists_sort_and_check_for_intersection (GList **list_a,
GList **list_b);
GList * eel_g_list_partition (GList *list,
EelPredicateFunction predicate,
gpointer user_data,
GList **removed);
/* List functions for lists of g_free'able objects. */
void eel_g_list_free_deep (GList *list);
void eel_g_list_free_deep_custom (GList *list,
GFunc element_free_func,
gpointer user_data);
/* GSList functions. */
GList * eel_g_list_from_g_slist (GSList *list);
GSList * eel_g_slist_from_g_list (GList *list);
/* List functions for slists of g_free'able objects. */
void eel_g_slist_free_deep (GSList *list);
void eel_g_slist_free_deep_custom (GSList *list,
GFunc element_free_func,
gpointer user_data);
/* List functions for lists of C strings. */
gboolean eel_g_str_list_equal (GList *str_list_a,
GList *str_list_b);
GList * eel_g_str_list_copy (GList *str_list);
GList * eel_g_str_list_alphabetize (GList *str_list);
int eel_g_str_list_index (GList *str_list,
const char *str);
/* List functions for lists of objects */
GList * eel_g_object_list_ref (GList *list);
void eel_g_object_list_unref (GList *list);
void eel_g_object_list_free (GList *list);
GList * eel_g_object_list_copy (GList *list);
/* GHashTable functions */
GHashTable *eel_g_hash_table_new_free_at_exit (GHashFunc hash_function,
GCompareFunc key_compare_function,
const char *display_name);
void eel_g_hash_table_safe_for_each (GHashTable *hash_table,
GHFunc callback,
gpointer callback_data);
/* NULL terminated string arrays (strv). */
int eel_g_strv_find (char **strv,
const char *find_me);
gboolean eel_g_strv_equal (char **a,
char **b);
/* return the time in microseconds since the machine was started */
gint64 eel_get_system_time (void);
/* math */
int eel_round (double d);
/* A GCompareFunc for integers */
int eel_compare_integer (gconstpointer a,
gconstpointer b);
/* Return the operating system name: Linux, Solaris, etc. */
char * eel_get_operating_system_name (void);
/* Better weak pointer functions */
void eel_add_weak_pointer (gpointer pointer_location);
void eel_remove_weak_pointer (gpointer pointer_location);
/* Get the filename encoding, returns TRUE if utf8 */
gboolean eel_get_filename_charset (const gchar **filename_charset);
void eel_g_settings_add_auto_enum (GSettings *settings,
const char *key,
int *storage);
void eel_g_settings_add_auto_int (GSettings *settings,
const char *key,
int *storage);
void eel_g_settings_add_auto_boolean (GSettings *settings,
const char *key,
gboolean *storage);
void eel_g_settings_add_auto_strv_as_quarks (GSettings *settings,
const char *key,
GQuark **storage);
#endif /* EEL_GLIB_EXTENSIONS_H */
|
