1 /* gfileutils.h - File utility functions
3 * Copyright 2000 Red Hat, Inc.
5 * GLib is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU Lesser General Public License as
7 * published by the Free Software Foundation; either version 2 of the
8 * License, or (at your option) any later version.
10 * GLib is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with GLib; see the file COPYING.LIB. If not,
17 * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
21 #if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
22 #error "Only <glib.h> can be included directly."
25 #ifndef __G_FILEUTILS_H__
26 #define __G_FILEUTILS_H__
28 #include <glib/gerror.h>
32 #define G_FILE_ERROR g_file_error_quark ()
39 G_FILE_ERROR_NAMETOOLONG,
63 /* For backward-compat reasons, these are synced to an old
64 * anonymous enum in libgnome. But don't use that enum
69 G_FILE_TEST_IS_REGULAR = 1 << 0,
70 G_FILE_TEST_IS_SYMLINK = 1 << 1,
71 G_FILE_TEST_IS_DIR = 1 << 2,
72 G_FILE_TEST_IS_EXECUTABLE = 1 << 3,
73 G_FILE_TEST_EXISTS = 1 << 4
76 GQuark g_file_error_quark (void);
77 /* So other code can generate a GFileError */
78 GFileError g_file_error_from_errno (gint err_no);
80 #ifndef __GTK_DOC_IGNORE__
82 #define g_file_test g_file_test_utf8
83 #define g_file_get_contents g_file_get_contents_utf8
84 #define g_mkstemp g_mkstemp_utf8
85 #define g_file_open_tmp g_file_open_tmp_utf8
89 gboolean g_file_test (const gchar *filename,
91 gboolean g_file_get_contents (const gchar *filename,
95 gboolean g_file_set_contents (const gchar *filename,
96 const gchar *contents,
99 gchar *g_file_read_link (const gchar *filename,
102 /* Wrapper / workalike for mkdtemp() */
103 gchar *g_mkdtemp (gchar *tmpl);
104 gchar *g_mkdtemp_full (gchar *tmpl,
107 /* Wrapper / workalike for mkstemp() */
108 gint g_mkstemp (gchar *tmpl);
109 gint g_mkstemp_full (gchar *tmpl,
113 /* Wrappers for g_mkstemp and g_mkdtemp() */
114 gint g_file_open_tmp (const gchar *tmpl,
117 gchar *g_dir_make_tmp (const gchar *tmpl,
122 G_FORMAT_SIZE_DEFAULT = 0,
123 G_FORMAT_SIZE_LONG_FORMAT = 1 << 0,
124 G_FORMAT_SIZE_IEC_UNITS = 1 << 1
127 gchar * g_format_size_full (guint64 size,
128 GFormatSizeFlags flags);
129 gchar * g_format_size (guint64 size);
131 #ifndef G_DISABLE_DEPRECATED
132 char *g_format_size_for_display (goffset size);
135 gchar *g_build_path (const gchar *separator,
136 const gchar *first_element,
137 ...) G_GNUC_MALLOC G_GNUC_NULL_TERMINATED;
138 gchar *g_build_pathv (const gchar *separator,
139 gchar **args) G_GNUC_MALLOC;
141 gchar *g_build_filename (const gchar *first_element,
142 ...) G_GNUC_MALLOC G_GNUC_NULL_TERMINATED;
143 gchar *g_build_filenamev (gchar **args) G_GNUC_MALLOC;
145 int g_mkdir_with_parents (const gchar *pathname,
150 #endif /* __G_FILEUTILS_H__ */