Add g_utf8_substring function for compiling with GLIB < 2.30.
[claws.git] / src / common / utils.h
index e94b4ca14624dcc6ca05aa26869165c4f961d4f3..1a1f6c49667d86b8258eb433b5c58ccceb76167f 100644 (file)
@@ -1,6 +1,6 @@
 /*
  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
- * Copyright (C) 1999-2007 Hiroyuki Yamamoto and the Claws Mail team
+ * Copyright (C) 1999-2012 Hiroyuki Yamamoto and the Claws Mail team
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  *
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
- * 
+ *
+ * The code of the g_utf8_substring function below is owned by
+ * Matthias Clasen <matthiasc@src.gnome.org>/<mclasen@redhat.com>
+ * and is got from GLIB 2.30
+ *
  */
 
 #ifndef __UTILS_H__
 #define __UTILS_H__
 
 #ifdef HAVE_CONFIG_H
-#  include "config.h"
+#include "claws-features.h"
+#endif
+
+#ifdef HAVE_BACKTRACE
+#include <execinfo.h>
 #endif
 
 #include <glib.h>
 #  include <wchar.h>
 #endif
 
+#ifdef G_OS_WIN32
+
+#define fsync _commit
+
+#if GLIB_CHECK_VERSION (2, 13, 2)
+#define pipe(phandles)  _pipe (phandles, 4096, _O_BINARY)
+#endif
+#endif
 /* Wrappers for C library function that take pathname arguments. */
 #if GLIB_CHECK_VERSION(2, 6, 0)
 #  include <glib/gstdio.h>
@@ -71,19 +87,11 @@ gint g_chmod        (const gchar    *path,
 
 #endif /* !GLIB_CHECK_VERSION */
 
-/* The AC_CHECK_SIZEOF() in configure fails for some machines.
- * we provide some fallback values here */
-#if !SIZEOF_UNSIGNED_SHORT
-  #undef SIZEOF_UNSIGNED_SHORT
-  #define SIZEOF_UNSIGNED_SHORT 2
-#endif
-#if !SIZEOF_UNSIGNED_INT
-  #undef SIZEOF_UNSIGNED_INT
-  #define SIZEOF_UNSIGNED_INT 4
-#endif
-#if !SIZEOF_UNSIGNED_LONG
-  #undef SIZEOF_UNSIGNED_LONG
-  #define SIZEOF_UNSIGNED_LONG 4
+/* why is this sometimes undefined !? */
+#ifndef G_MAXOFFSET
+typedef gint64 goffset;
+#define G_MINOFFSET    G_MININT64
+#define G_MAXOFFSET    G_MAXINT64
 #endif
 
 #ifndef HAVE_U32_TYPEDEF
@@ -187,6 +195,58 @@ gint g_chmod       (const gchar    *path,
 
 #define IS_ASCII(c) (((guchar) c) <= 0177 ? 1 : 0)
 
+/* from NetworkManager */
+#if (defined(HAVE_BACKTRACE) && !defined(__FreeBSD__))
+#define print_backtrace()                                              \
+G_STMT_START                                                           \
+{                                                                      \
+       void *_call_stack[512];                                         \
+       int  _call_stack_size;                                          \
+       char **_symbols;                                                \
+       _call_stack_size = backtrace (_call_stack,                      \
+                                     G_N_ELEMENTS (_call_stack));      \
+       _symbols = backtrace_symbols (_call_stack, _call_stack_size);   \
+       if (_symbols != NULL)                                           \
+       {                                                               \
+               int _i;                                                 \
+               _i = 0;                                                 \
+               g_print ("traceback:\n");                               \
+               while (_i < _call_stack_size)                           \
+               {                                                       \
+                       g_print ("%d:\t%s\n", _i, _symbols[_i]);        \
+                       _i++;                                           \
+               }                                                       \
+               free (_symbols);                                        \
+       }                                                               \
+}                                                                      \
+G_STMT_END
+#else
+#define print_backtrace()                                              \
+G_STMT_START                                                           \
+{                                                                      \
+}                                                                      \
+G_STMT_END
+#endif
+
+
+#define cm_return_val_if_fail(expr,val) G_STMT_START {                 \
+       if (!(expr)) {                                                  \
+               g_print("%s:%d Condition %s failed\n", __FILE__, __LINE__, #expr);\
+               print_backtrace();                                      \
+               g_print("\n");                                          \
+               return val;                                             \
+       }                                                               \
+} G_STMT_END
+
+#define cm_return_if_fail(expr) G_STMT_START {                         \
+       if (!(expr)) {                                                  \
+               g_print("%s:%d Condition %s failed\n", __FILE__, __LINE__, #expr);\
+               print_backtrace();                                      \
+               g_print("\n");                                          \
+               return;                                                 \
+       }                                                               \
+} G_STMT_END
+
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ -217,11 +277,16 @@ gboolean debug_get_mode           (void);
 
 gboolean superuser_p (void);
 
+/* List utilities. */
+
+GSList *slist_copy_deep                (GSList         *list,
+                                GCopyFunc       func);
 
 /* String utilities.  */
 
 void list_free_strings         (GList          *list);
 void slist_free_strings                (GSList         *list);
+void slist_free_strings_full   (GSList         *list);
 
 void hash_free_strings         (GHashTable     *table);
 
@@ -231,19 +296,12 @@ guint str_case_hash               (gconstpointer   key);
 
 void ptr_array_free_strings    (GPtrArray      *array);
 
-typedef gboolean (*StrFindFunc) (const gchar   *haystack,
-                                const gchar    *needle);
-
-gboolean str_find              (const gchar    *haystack,
-                                const gchar    *needle);
-gboolean str_case_find         (const gchar    *haystack,
-                                const gchar    *needle);
 /* number-string conversion */
 gint to_number                 (const gchar *nstr);
 gchar *itos_buf                        (gchar       *nstr,
                                 gint         n);
 gchar *itos                    (gint         n);
-gchar *to_human_readable       (off_t        size);
+gchar *to_human_readable       (goffset      size);
 
 /* alternative string functions */
 gint strcmp2           (const gchar    *s1,
@@ -259,6 +317,9 @@ gchar *strcrchomp   (gchar          *str);
 gint file_strip_crs    (const gchar    *file);
 gchar *strcasestr      (const gchar    *haystack,
                         const gchar    *needle);
+gchar *strncasestr     (const gchar    *haystack,
+                        gint            haystack_len,
+                        const gchar    *needle);
 gpointer my_memmem     (gconstpointer   haystack,
                         size_t          haystacklen,
                         gconstpointer   needle,
@@ -285,6 +346,8 @@ void extract_parenthesis            (gchar          *str,
 
 void extract_quote                     (gchar          *str,
                                         gchar           quote_chr);
+gchar *escape_internal_quotes          (gchar          *str,
+                                        gchar           quote_chr);
 void eliminate_address_comment         (gchar          *str);
 gchar *strchr_with_skip_quote          (const gchar    *str,
                                         gint            quote_chr,
@@ -312,6 +375,9 @@ void unfold_line                    (gchar          *str);
 void subst_char                                (gchar          *str,
                                         gchar           orig,
                                         gchar           subst);
+void subst_chars                       (gchar          *str,   
+                                        gchar          *orig, 
+                                        gchar          subst);
 void subst_for_filename                        (gchar          *str);
 void subst_for_shellsafe_filename      (gchar          *str);
 gboolean is_ascii_str                  (const gchar    *str);
@@ -340,12 +406,14 @@ void decode_uri_with_plus         (gchar          *decoded_uri,
                                         const gchar    *encoded_uri, 
                                         gboolean        with_plus);
 gint scan_mailto_url                   (const gchar    *mailto,
+                                        gchar         **from,
                                         gchar         **to,
                                         gchar         **cc,
                                         gchar         **bcc,
                                         gchar         **subject,
                                         gchar         **body,
-                                        gchar         ***attach);
+                                        gchar         ***attach,
+                                        gchar         **inreplyto);
 
 /* return static strings */
 const gchar *get_home_dir              (void);
@@ -362,7 +430,11 @@ const gchar *get_tmp_dir           (void);
 const gchar *get_locale_dir            (void);
 gchar *get_tmp_file                    (void);
 const gchar *get_domain_name           (void);
-
+const gchar *get_desktop_file(void);
+#ifdef G_OS_WIN32
+const gchar *get_themes_dir             (void);
+const gchar *get_cert_file             (void);
+#endif
 /* file / directory handling */
 off_t get_file_size            (const gchar    *file);
 off_t get_file_size_as_crlf    (const gchar    *file);
@@ -431,6 +503,8 @@ gint str_write_to_file              (const gchar    *str,
                                 const gchar    *file);
 gchar *file_read_to_str                (const gchar    *file);
 gchar *file_read_stream_to_str (FILE           *fp);
+gchar *file_read_to_str_no_recode(const gchar *file);
+gchar *file_read_stream_to_str_no_recode(FILE *fp);
 
 char *fgets_crlf(char *buf, int size, FILE *stream);
 
@@ -465,6 +539,7 @@ void * subject_table_lookup(GHashTable *subject_table, gchar * subject);
 void subject_table_insert(GHashTable *subject_table, gchar * subject,
                          void * data);
 void subject_table_remove(GHashTable *subject_table, gchar * subject);
+void utils_free_regex(void);
 gint subject_get_prefix_length (const gchar *subject);
 
 /* quoting recognition */
@@ -473,7 +548,7 @@ const gchar * line_has_quote_char   (const gchar *str,
 
 gint g_int_compare     (gconstpointer a, gconstpointer b);
 
-gchar *generate_msgid          (gchar *buf, gint len);
+gchar *generate_msgid          (gchar *buf, gint len, gchar *user_addr);
 gchar *generate_mime_boundary  (const gchar *prefix);
 
 gint quote_cmd_argument(gchar * result, guint size,
@@ -520,6 +595,20 @@ void mailcap_update_default           (const gchar *type,
 gboolean file_is_email(const gchar *filename);
 gboolean sc_g_list_bigger(GList *list, gint max);
 gboolean sc_g_slist_bigger(GSList *list, gint max);
+
+int claws_unlink(const gchar *filename);
+
+GMutex *cm_mutex_new(void);
+void cm_mutex_free(GMutex *mutex);
+
+int cm_canonicalize_filename(const gchar *filename, gchar **canonical_name);
+
+#if !GLIB_CHECK_VERSION(2, 30, 0)
+gchar   *g_utf8_substring         (const gchar *p,
+                                   glong        start_pos,
+                                   glong        end_pos) G_GNUC_MALLOC;
+#endif
+
 #ifdef __cplusplus
 }
 #endif