summaryrefslogtreecommitdiff
path: root/eel/eel-glib-extensions.h
diff options
context:
space:
mode:
Diffstat (limited to 'eel/eel-glib-extensions.h')
-rw-r--r--eel/eel-glib-extensions.h128
1 files changed, 128 insertions, 0 deletions
diff --git a/eel/eel-glib-extensions.h b/eel/eel-glib-extensions.h
new file mode 100644
index 00000000..ac36fe7e
--- /dev/null
+++ b/eel/eel-glib-extensions.h
@@ -0,0 +1,128 @@
+/* -*- 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., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA.
+
+ Authors: John Sullivan <[email protected]>
+*/
+
+#ifndef EEL_GLIB_EXTENSIONS_H
+#define EEL_GLIB_EXTENSIONS_H
+
+#include <glib.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);
+
+
+#endif /* EEL_GLIB_EXTENSIONS_H */