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
|
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/* nautilus-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 Gnome 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 Gnome 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 Gnome Library; see the file COPYING.LIB. If not,
write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
Authors: John Sullivan <sullivan@eazel.com>
*/
#ifndef NAUTILUS_GLIB_EXTENSIONS_H
#define NAUTILUS_GLIB_EXTENSIONS_H
#include <time.h>
#include <glib.h>
/* A gboolean variant for bit fields. */
typedef guint nautilus_boolean_bit;
/* Use there to start and and end a macro */
#define NAUTILUS_MACRO_BEGIN G_STMT_START {
#define NAUTILUS_MACRO_END } G_STMT_END
/* Use this until we can switch to G_N_ELEMENTS. */
#define NAUTILUS_N_ELEMENTS(array) (sizeof (array) / sizeof ((array)[0]))
/* Callback functions that have user data. */
typedef int (* NautilusCompareFunction) (gconstpointer a,
gconstpointer b,
gpointer callback_data);
typedef int (* NautilusSearchFunction) (gconstpointer item,
gpointer callback_data);
/* Predicate. */
typedef gboolean (* NautilusPredicateFunction) (gpointer data,
gpointer callback_data);
/* Date & time functions. */
GDate * nautilus_g_date_new_tm (struct tm *time_pieces);
char * nautilus_strdup_strftime (const char *format,
struct tm *time_pieces);
/* environment manipulation functions */
int nautilus_setenv (const char *name,
const char *value,
gboolean overwrite);
void nautilus_unsetenv (const char *name);
/* GList functions. */
gboolean nautilus_g_list_exactly_one_item (GList *list);
gboolean nautilus_g_list_more_than_one_item (GList *list);
gboolean nautilus_g_list_equal (GList *list_a,
GList *list_b);
GList * nautilus_g_list_copy (GList *list);
void nautilus_g_list_safe_for_each (GList *list,
GFunc function,
gpointer user_data);
GList * nautilus_g_list_partition (GList *list,
NautilusPredicateFunction predicate,
gpointer user_data,
GList **removed);
void nautilus_g_list_free_deep_custom (GList *list,
GFunc element_free_func,
gpointer user_data);
/* List functions for lists of g_free'able objects. */
void nautilus_g_list_free_deep (GList *list);
void nautilus_g_slist_free_deep_custom (GSList *list,
GFunc element_free_func,
gpointer user_data);
/* List functions for slists of g_free'able objects. */
void nautilus_g_slist_free_deep (GSList *list);
/* List functions for lists of C strings. */
gboolean nautilus_g_str_list_equal (GList *str_list_a,
GList *str_list_b);
GList * nautilus_g_str_list_copy (GList *str_list);
GList * nautilus_g_str_list_sort (GList *str_list);
GList * nautilus_g_str_list_sort_case_insensitive (GList *str_list);
/* GString functions */
void nautilus_g_string_append_len (GString *string,
const char *characters,
int length);
/* GHashTable functions */
GHashTable *nautilus_g_hash_table_new_free_at_exit (GHashFunc hash_function,
GCompareFunc key_compare_function,
const char *display_name);
void nautilus_g_hash_table_safe_for_each (GHashTable *hash_table,
GHFunc callback,
gpointer callback_data);
/* GPtrArray functions */
GPtrArray * nautilus_g_ptr_array_new_from_list (GList *list);
void nautilus_g_ptr_array_sort (GPtrArray *array,
NautilusCompareFunction compare_callback,
gpointer callback_data);
int nautilus_g_ptr_array_search (GPtrArray *array,
NautilusSearchFunction search_callback,
gpointer callback_data,
gboolean match_only);
/* NULL terminated string arrays (strv). */
int nautilus_g_strv_find (char **strv,
const char *find_me);
/* return the time in microseconds since the machine was started */
gint64 nautilus_get_system_time (void);
/* shell */
char * nautilus_shell_quote (const char *string);
#endif /* NAUTILUS_GLIB_EXTENSIONS_H */
|
