moving from https://github.com/perberos/mate-desktop-environment

1 files changed, 122 insertions, 0 deletions

diff --git a/eel/eel-string.h b/eel/eel-string.h
new file mode 100644
index 00000000..ffd5c647
--- /dev/null
+++ b/eel/eel-string.h
@@ -0,0 +1,122 @@
+/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*-
+
+   eel-string.h: String routines to augment <string.h>.
+
+   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: Darin Adler <[email protected]>
+*/
+
+#ifndef EEL_STRING_H
+#define EEL_STRING_H
+
+#include <glib.h>
+
+#include <string.h>
+#include <stdarg.h>
+
+/* We use the "str" abbrevation to mean char * string, since
+ * "string" usually means g_string instead. We use the "istr"
+ * abbreviation to mean a case-insensitive char *.
+ */
+
+
+/* NULL is allowed for all the str parameters to these functions. */
+
+/* Versions of basic string functions that allow NULL, and handle
+ * cases that the standard ones get a bit wrong for our purposes.
+ */
+size_t   eel_strlen                        (const char    *str);
+char *   eel_strchr                        (const char    *haystack,
+        char           needle);
+int      eel_strcmp                        (const char    *str_a,
+        const char    *str_b);
+int      eel_strcasecmp                    (const char    *str_a,
+        const char    *str_b);
+int      eel_strcmp_case_breaks_ties       (const char    *str_a,
+        const char    *str_b);
+
+/* Other basic string operations. */
+gboolean eel_str_is_empty                  (const char    *str_or_null);
+gboolean eel_str_is_equal                  (const char    *str_a,
+        const char    *str_b);
+gboolean eel_istr_is_equal                 (const char    *str_a,
+        const char    *str_b);
+gboolean eel_str_has_prefix                (const char    *target,
+        const char    *prefix);
+char *   eel_str_get_prefix                (const char    *source,
+        const char    *delimiter);
+gboolean eel_istr_has_prefix               (const char    *target,
+        const char    *prefix);
+gboolean eel_str_has_suffix                (const char    *target,
+        const char    *suffix);
+gboolean eel_istr_has_suffix               (const char    *target,
+        const char    *suffix);
+
+/* Conversions to and from strings. */
+gboolean eel_str_to_int                    (const char    *str,
+        int           *integer);
+
+/* Escape function for '_' character. */
+char *   eel_str_double_underscores        (const char    *str);
+
+/* Capitalize a string */
+char *   eel_str_capitalize                (const char    *str);
+
+/* Middle truncate a string to a maximum of truncate_length characters.
+ * The resulting string will be truncated in the middle with a "..."
+ * delimiter.
+ */
+char *   eel_str_middle_truncate           (const char    *str,
+        guint          truncate_length);
+
+
+/* Remove all characters after the passed-in substring. */
+char *   eel_str_strip_substring_and_after (const char    *str,
+        const char    *substring);
+
+/* Replace all occurrences of substring with replacement. */
+char *   eel_str_replace_substring         (const char    *str,
+        const char    *substring,
+        const char    *replacement);
+
+typedef char * eel_ref_str;
+
+eel_ref_str eel_ref_str_new        (const char  *string);
+eel_ref_str eel_ref_str_get_unique (const char  *string);
+eel_ref_str eel_ref_str_ref        (eel_ref_str  str);
+void        eel_ref_str_unref      (eel_ref_str  str);
+
+#define eel_ref_str_peek(__str) ((const char *)(__str))
+
+
+typedef struct
+{
+    char character;
+    char *(*to_string) (char *format, va_list va);
+    void (*skip) (va_list *va);
+} EelPrintfHandler;
+
+char *eel_strdup_printf_with_custom (EelPrintfHandler *handlers,
+                                     const char *format,
+                                     ...);
+char *eel_strdup_vprintf_with_custom (EelPrintfHandler *custom,
+                                      const char *format,
+                                      va_list va);
+
+#endif /* EEL_STRING_H */