patch by Satoshi Nagayasu: allows appending / saving multiple
[claws.git] / src / utils.h
index 91230cb8031f1c1ebb056240d10a016acd5d8b96..d2344d5ba97d5dd78dad5f731b40e35e1f8197e0 100644 (file)
@@ -1,6 +1,6 @@
 /*
  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
- * Copyright (C) 1999-2001 Hiroyuki Yamamoto
+ * Copyright (C) 1999-2002 Hiroyuki Yamamoto
  *
  * 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
        ptr = __tmp; \
 }
 
+#define Xstrcat_a(ptr, str1, str2, iffail) \
+{ \
+       gchar *__tmp; \
+       gint len1, len2; \
+ \
+       len1 = strlen(str1); \
+       len2 = strlen(str2); \
+       if ((__tmp = alloca(len1 + len2 + 1)) == NULL) { \
+               g_warning("can't allocate memory\n"); \
+               iffail; \
+       } else { \
+               memcpy(__tmp, str1, len1); \
+               memcpy(__tmp + len1, str2, len2 + 1); \
+       } \
+ \
+       ptr = __tmp; \
+}
+
 #define FILE_OP_ERROR(file, func) \
 { \
        fprintf(stderr, "%s: ", file); \
        perror(func); \
 }
 
+#define debug_print \
+       debug_print_real(__FILE__ ":%d:", __LINE__), \
+       debug_print_real
+
 /* for macro expansion */
 #define Str(x) #x
 #define Xstr(x)        Str(x)
@@ -125,6 +147,7 @@ void list_free_strings              (GList          *list);
 void slist_free_strings                (GSList         *list);
 
 void hash_free_strings         (GHashTable     *table);
+void hash_free_value_mem       (GHashTable     *table);
 
 void ptr_array_free_strings    (GPtrArray      *array);
 
@@ -138,11 +161,14 @@ gchar *to_human_readable  (off_t        size);
 /* alternative string functions */
 gint strcmp2           (const gchar    *s1,
                         const gchar    *s2);
+gchar *strstr2         (const gchar    *s1,
+                        const gchar    *s2);
 gint path_cmp          (const gchar    *s1,
                         const gchar    *s2);
 gchar *strretchomp     (gchar          *str);
 gchar *strtailchomp    (gchar          *str,
                         gchar           tail_char);
+gchar *strcrchomp      (gchar          *str);
 gchar *strcasestr      (const gchar    *haystack,
                         const gchar    *needle);
 gchar *strncpy2                (gchar          *dest,
@@ -220,28 +246,53 @@ gchar *strrchr_with_skip_quote            (const gchar    *str,
                                         gint            quote_chr,
                                         gint            c);
 void extract_address                   (gchar          *str);
+
 GSList *address_list_append            (GSList         *addr_list,
                                         const gchar    *str);
 GSList *references_list_append         (GSList         *msgid_list,
                                         const gchar    *str);
 GSList *newsgroup_list_append          (GSList         *group_list,
                                         const gchar    *str);
+
+GList *add_history                     (GList          *list,
+                                        const gchar    *str);
+
 void remove_return                     (gchar          *str);
 void remove_space                      (gchar          *str);
 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);
 gboolean is_header_line                        (const gchar    *str);
 gboolean is_ascii_str                  (const guchar   *str);
-gint get_quote_level                   (const gchar    *str);
-GList *uri_list_extract_filenames      (const gchar    *uri_list);
+gint get_quote_level                   (const gchar    *str,
+                                        const gchar    *quote_chars);
 gchar *strstr_with_skip_quote          (const gchar    *haystack,
                                         const gchar    *needle);
+gchar *strchr_parenthesis_close                (const gchar    *str,
+                                        gchar           op,
+                                        gchar           cl);
+
+gchar **strsplit_parenthesis           (const gchar    *str,
+                                        gchar           op,
+                                        gchar           cl,
+                                        gint            max_tokens);
 gchar **strsplit_with_quote            (const gchar    *str,
                                         const gchar    *delim,
                                         gint            max_tokens);
 
+gchar *get_abbrev_newsgroup_name       (const gchar    *group);
+gchar *trim_string                     (const gchar    *str,
+                                        gint            len);
+
+GList *uri_list_extract_filenames      (const gchar    *uri_list);
+void decode_uri                                (gchar          *decoded_uri,
+                                        const gchar    *encoded_uri);
+
 /* return static strings */
 gchar *get_home_dir            (void);
 gchar *get_rc_dir              (void);
@@ -249,37 +300,65 @@ gchar *get_news_cache_dir (void);
 gchar *get_imap_cache_dir      (void);
 gchar *get_mbox_cache_dir      (void);
 gchar *get_mime_tmp_dir                (void);
+gchar *get_template_dir                (void);
+gchar *get_header_cache_dir     (void);
+gchar *get_tmp_dir             (void);
 gchar *get_tmp_file            (void);
 gchar *get_domain_name         (void);
 
 /* file / directory handling */
 off_t get_file_size            (const gchar    *file);
+off_t get_file_size_as_crlf    (const gchar    *file);
 off_t get_left_file_size       (FILE           *fp);
+
 gboolean file_exist            (const gchar    *file,
                                 gboolean        allow_fifo);
 gboolean is_dir_exist          (const gchar    *dir);
+gboolean is_file_entry_exist   (const gchar    *file);
+
+#define is_file_exist(file)            file_exist(file, FALSE)
+#define is_file_or_fifo_exist(file)    file_exist(file, TRUE)
+
 gint change_dir                        (const gchar    *dir);
+gint make_dir                  (const gchar    *dir);
 gint make_dir_hier             (const gchar    *dir);
 gint remove_all_files          (const gchar    *dir);
 gint remove_numbered_files     (const gchar    *dir,
-                                gint            first,
-                                gint            last);
+                                guint           first,
+                                guint           last);
 gint remove_all_numbered_files (const gchar    *dir);
+gint remove_expired_files      (const gchar    *dir,
+                                guint           hours);
 gint remove_dir_recursive      (const gchar    *dir);
+gint append_file               (const gchar    *src,
+                                const gchar    *dest,
+                                gboolean        keep_backup);
 gint copy_file                 (const gchar    *src,
-                                const gchar    *dest);
+                                const gchar    *dest,
+                                gboolean        keep_backup);
 gint move_file                 (const gchar    *src,
+                                const gchar    *dest,
+                                gboolean        overwrite);
+gint copy_file_part            (FILE           *fp,
+                                off_t           offset,
+                                size_t          length,
                                 const gchar    *dest);
+gint canonicalize_file         (const gchar    *src,
+                                const gchar    *dest);
+gint canonicalize_file_replace (const gchar    *file);
 gint change_file_mode_rw       (FILE           *fp,
                                 const gchar    *file);
 FILE *my_tmpfile               (void);
-
-#define is_file_exist(file)            file_exist(file, FALSE)
-#define is_file_or_fifo_exist(file)    file_exist(file, TRUE)
+FILE *str_open_as_stream       (const gchar    *str);
+gint str_write_to_file         (const gchar    *str,
+                                const gchar    *file);
+gchar *file_read_to_str                (const gchar    *file);
 
 /* process execution */
 gint execute_async             (gchar *const    argv[]);
-gint execute_command_line      (const gchar    *cmdline);
+gint execute_sync              (gchar *const    argv[]);
+gint execute_command_line      (const gchar    *cmdline,
+                                gboolean        async);
 
 /* open URI with external browser */
 gint open_uri(const gchar *uri, const gchar *cmdline);
@@ -292,10 +371,27 @@ void get_rfc822_date              (gchar          *buf,
                                 gint            len);
 
 /* logging */
-void debug_print(const gchar *format, ...) G_GNUC_PRINTF(1, 2);
-void log_print (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
-void log_message(const gchar *format, ...) G_GNUC_PRINTF(1, 2);
-void log_warning(const gchar *format, ...) G_GNUC_PRINTF(1, 2);
-void log_error (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
+void set_log_file      (const gchar *filename);
+void close_log_file    (void);
+void log_verbosity_set (gboolean verbose);
+void debug_print_real  (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
+void log_print         (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
+void log_message       (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
+void log_warning       (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
+void log_error         (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
+
+/* subject threading */
+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);
+gboolean subject_is_reply(const gchar *subject);
+
+/* quoting recognition */
+const gchar * line_has_quote_char      (const gchar *str,
+                                        const gchar *quote_chars);
+const gchar * line_has_quote_char_last (const gchar *str,
+                                        const gchar *quote_chars);
+
 
 #endif /* __UTILS_H__ */