clang-tidy: readability-inconsistent-declaration-parameter-name
[geeqie.git] / src / ui-fileops.h
1 /*
2  * Copyright (C) 2004 John Ellis
3  * Copyright (C) 2008 - 2016 The Geeqie Team
4  *
5  * Author: John Ellis
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License along
18  * with this program; if not, write to the Free Software Foundation, Inc.,
19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20  */
21
22 #ifndef UI_FILEOPS_H
23 #define UI_FILEOPS_H
24 #include <config.h>
25 #include <sys/stat.h>
26 #include <sys/time.h>
27 #include <sys/types.h>
28 #include <time.h>
29
30
31
32 void print_term(gboolean err, const gchar *text_utf8);
33
34 #define printf_term(err, ...) \
35         do { \
36                 gchar *msg = g_strdup_printf(__VA_ARGS__); \
37                 print_term(err, msg); \
38                 g_free(msg); \
39         } while (0)
40
41 #if GQ_DEBUG_PATH_UTF8
42 #define path_to_utf8(path) path_to_utf8_debug(path, __FILE__, __LINE__)
43 #define path_from_utf8(utf8) path_from_utf8_debug(utf8, __FILE__, __LINE__)
44 gchar *path_to_utf8_debug(const gchar *path, const gchar *file, gint line);
45 gchar *path_from_utf8_debug(const gchar *utf8, const gchar *file, gint line);
46 #else
47 gchar *path_to_utf8(const gchar *path);
48 gchar *path_from_utf8(const gchar *utf8);
49 #endif
50
51 const gchar *xdg_data_home_get();
52 const gchar *xdg_config_home_get();
53 const gchar *xdg_cache_home_get();
54 const gchar *homedir();
55 const gchar *get_rc_dir();
56 const gchar *get_collections_dir();
57 const gchar *get_trash_dir();
58 const gchar *get_window_layouts_dir();
59
60 gboolean stat_utf8(const gchar *s, struct stat *st);
61 gboolean lstat_utf8(const gchar *s, struct stat *st);
62
63 gboolean isname(const gchar *s);
64 gboolean isfile(const gchar *s);
65 gboolean isdir(const gchar *s);
66 gboolean islink(const gchar *s);
67 gint64 filesize(const gchar *s);
68 time_t filetime(const gchar *s);
69 gboolean filetime_set(const gchar *s, time_t tval);
70 gboolean is_readable_file(const gchar *s);
71 gboolean access_file(const gchar *s, gint mode);
72 gboolean unlink_file(const gchar *s);
73 gboolean mkdir_utf8(const gchar *s, gint mode);
74 gboolean rmdir_utf8(const gchar *s);
75 gboolean copy_file_attributes(const gchar *s, const gchar *t, gint perms, gint mtime);
76 gboolean copy_file(const gchar *s, const gchar *t);
77 gboolean move_file(const gchar *s, const gchar *t);
78 gboolean rename_file(const gchar *s, const gchar *t);
79 gchar *get_current_dir();
80
81 /**
82  * @headerfile string_list_free
83  * return True on success, it is up to you to free
84  * the lists with string_list_free()
85  */
86 void string_list_free(GList *list);
87 GList *string_list_copy(const GList *list);
88
89 gchar *unique_filename(const gchar *path, const gchar *ext, const gchar *divider, gboolean pad);
90
91 const gchar *filename_from_path(const gchar *path);
92 gchar *remove_level_from_path(const gchar *path);
93
94 gchar *remove_extension_from_path(const gchar *path);
95
96 gboolean file_extension_match(const gchar *path, const gchar *ext);
97
98 /**
99  * @headerfile parse_out_relatives
100  * warning note: this modifies path string!
101  */
102 void parse_out_relatives(gchar *path);
103
104 gboolean file_in_path(const gchar *name);
105
106 gboolean recursive_mkdir_if_not_exists(const gchar *path, mode_t mode);
107
108
109 /**
110  * @headerfile md5_text_from_file_utf8
111  * generate md5 string from file,
112  * on failure returns newly allocated copy of error_text, error_text may be NULL
113  */
114 gchar *md5_text_from_file_utf8(const gchar *path, const gchar *error_text);
115 gboolean md5_get_digest_from_file_utf8(const gchar *path, guchar digest[16]);
116
117 gboolean download_web_file(const gchar *text, gboolean minimized, gpointer data);
118 gboolean rmdir_recursive(GFile *file, GCancellable *cancellable, GError **error);
119 gint scale_factor();
120
121 #endif
122 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */