1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GIO Reference Manual">
8 <link rel="up" href="file_ops.html" title="File Operations">
9 <link rel="prev" href="file_ops.html" title="File Operations">
10 <link rel="next" href="gio-GFileAttribute.html" title="GFileAttribute">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="file_ops.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="file_ops.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GIO Reference Manual</th>
21 <td><a accesskey="n" href="gio-GFileAttribute.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GFile.synopsis" class="shortcut">Top</a>
26 <a href="#GFile.description" class="shortcut">Description</a>
28 <a href="#GFile.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GFile.prerequisites" class="shortcut">Prerequisites</a>
33 <div class="refentry">
34 <a name="GFile"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
37 <h2><span class="refentrytitle"><a name="GFile.top_of_page"></a>GFile</span></h2>
38 <p>GFile — File and Directory Handling</p>
40 <td valign="top" align="right"></td>
42 <div class="refsynopsisdiv">
43 <a name="GFile.synopsis"></a><h2>Synopsis</h2>
44 <a name="GFileMonitorFlags"></a><pre class="synopsis">
45 #include <gio/gio.h>
47 <a class="link" href="GFile.html#GFile-struct" title="GFile">GFile</a>;
48 struct <a class="link" href="GFile.html#GFileIface" title="struct GFileIface">GFileIface</a>;
49 enum <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a>;
50 enum <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a>;
51 enum <a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags">GFileCopyFlags</a>;
52 enum <a class="link" href="GFile.html#GFileMonitorFlags-enum" title="enum GFileMonitorFlags">GFileMonitorFlags</a>;
53 enum <a class="link" href="GFile.html#GFilesystemPreviewType" title="enum GFilesystemPreviewType">GFilesystemPreviewType</a>;
54 <span class="returnvalue">void</span> (<a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()">*GFileProgressCallback</a>) (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> current_num_bytes</code></em>,
55 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> total_num_bytes</code></em>,
56 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
57 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()">*GFileReadMoreCallback</a>) (<em class="parameter"><code>const <span class="type">char</span> *file_contents</code></em>,
58 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> file_size</code></em>,
59 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);
60 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-new-for-path" title="g_file_new_for_path ()">g_file_new_for_path</a> (<em class="parameter"><code>const <span class="type">char</span> *path</code></em>);
61 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-new-for-uri" title="g_file_new_for_uri ()">g_file_new_for_uri</a> (<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);
62 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-new-for-commandline-arg" title="g_file_new_for_commandline_arg ()">g_file_new_for_commandline_arg</a> (<em class="parameter"><code>const <span class="type">char</span> *arg</code></em>);
63 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-new-tmp" title="g_file_new_tmp ()">g_file_new_tmp</a> (<em class="parameter"><code>const <span class="type">char</span> *tmpl</code></em>,
64 <em class="parameter"><code><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> **iostream</code></em>,
65 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
66 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-parse-name" title="g_file_parse_name ()">g_file_parse_name</a> (<em class="parameter"><code>const <span class="type">char</span> *parse_name</code></em>);
67 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-dup" title="g_file_dup ()">g_file_dup</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
68 <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="GFile.html#g-file-hash" title="g_file_hash ()">g_file_hash</a> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> file</code></em>);
69 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-equal" title="g_file_equal ()">g_file_equal</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file1</code></em>,
70 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file2</code></em>);
71 <span class="returnvalue">char</span> * <a class="link" href="GFile.html#g-file-get-basename" title="g_file_get_basename ()">g_file_get_basename</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
72 <span class="returnvalue">char</span> * <a class="link" href="GFile.html#g-file-get-path" title="g_file_get_path ()">g_file_get_path</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
73 <span class="returnvalue">char</span> * <a class="link" href="GFile.html#g-file-get-uri" title="g_file_get_uri ()">g_file_get_uri</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
74 <span class="returnvalue">char</span> * <a class="link" href="GFile.html#g-file-get-parse-name" title="g_file_get_parse_name ()">g_file_get_parse_name</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
75 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-get-parent" title="g_file_get_parent ()">g_file_get_parent</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
76 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-has-parent" title="g_file_has_parent ()">g_file_has_parent</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
77 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *parent</code></em>);
78 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-get-child" title="g_file_get_child ()">g_file_get_child</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
79 <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);
80 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-get-child-for-display-name" title="g_file_get_child_for_display_name ()">g_file_get_child_for_display_name</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
81 <em class="parameter"><code>const <span class="type">char</span> *display_name</code></em>,
82 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
83 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-has-prefix" title="g_file_has_prefix ()">g_file_has_prefix</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
84 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *prefix</code></em>);
85 <span class="returnvalue">char</span> * <a class="link" href="GFile.html#g-file-get-relative-path" title="g_file_get_relative_path ()">g_file_get_relative_path</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *parent</code></em>,
86 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *descendant</code></em>);
87 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-resolve-relative-path" title="g_file_resolve_relative_path ()">g_file_resolve_relative_path</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
88 <em class="parameter"><code>const <span class="type">char</span> *relative_path</code></em>);
89 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-is-native" title="g_file_is_native ()">g_file_is_native</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
90 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-has-uri-scheme" title="g_file_has_uri_scheme ()">g_file_has_uri_scheme</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
91 <em class="parameter"><code>const <span class="type">char</span> *uri_scheme</code></em>);
92 <span class="returnvalue">char</span> * <a class="link" href="GFile.html#g-file-get-uri-scheme" title="g_file_get_uri_scheme ()">g_file_get_uri_scheme</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
93 <a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="returnvalue">GFileInputStream</span></a> * <a class="link" href="GFile.html#g-file-read" title="g_file_read ()">g_file_read</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
94 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
95 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
96 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-read-async" title="g_file_read_async ()">g_file_read_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
97 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
98 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
99 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
100 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
101 <a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="returnvalue">GFileInputStream</span></a> * <a class="link" href="GFile.html#g-file-read-finish" title="g_file_read_finish ()">g_file_read_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
102 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
103 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
104 <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * <a class="link" href="GFile.html#g-file-append-to" title="g_file_append_to ()">g_file_append_to</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
105 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
106 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
107 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
108 <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * <a class="link" href="GFile.html#g-file-create" title="g_file_create ()">g_file_create</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
109 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
110 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
111 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
112 <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * <a class="link" href="GFile.html#g-file-replace" title="g_file_replace ()">g_file_replace</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
113 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
114 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
115 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
116 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
117 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
118 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-append-to-async" title="g_file_append_to_async ()">g_file_append_to_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
119 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
120 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
121 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
122 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
123 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
124 <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * <a class="link" href="GFile.html#g-file-append-to-finish" title="g_file_append_to_finish ()">g_file_append_to_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
125 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
126 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
127 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-create-async" title="g_file_create_async ()">g_file_create_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
128 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
129 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
130 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
131 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
132 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
133 <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * <a class="link" href="GFile.html#g-file-create-finish" title="g_file_create_finish ()">g_file_create_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
134 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
135 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
136 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-replace-async" title="g_file_replace_async ()">g_file_replace_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
137 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
138 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
139 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
140 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
141 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
142 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
143 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
144 <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * <a class="link" href="GFile.html#g-file-replace-finish" title="g_file_replace_finish ()">g_file_replace_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
145 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
146 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
147 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()">g_file_query_info</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
148 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
149 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
150 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
151 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
152 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-query-info-async" title="g_file_query_info_async ()">g_file_query_info_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
153 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
154 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
155 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
156 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
157 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
158 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
159 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * <a class="link" href="GFile.html#g-file-query-info-finish" title="g_file_query_info_finish ()">g_file_query_info_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
160 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
161 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
162 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-query-exists" title="g_file_query_exists ()">g_file_query_exists</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
163 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>);
164 <a class="link" href="GFileInfo.html#GFileType" title="enum GFileType"><span class="returnvalue">GFileType</span></a> <a class="link" href="GFile.html#g-file-query-file-type" title="g_file_query_file_type ()">g_file_query_file_type</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
165 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
166 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>);
167 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * <a class="link" href="GFile.html#g-file-query-filesystem-info" title="g_file_query_filesystem_info ()">g_file_query_filesystem_info</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
168 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
169 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
170 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
171 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-query-filesystem-info-async" title="g_file_query_filesystem_info_async ()">g_file_query_filesystem_info_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
172 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
173 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
174 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
175 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
176 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
177 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * <a class="link" href="GFile.html#g-file-query-filesystem-info-finish" title="g_file_query_filesystem_info_finish ()">g_file_query_filesystem_info_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
178 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
179 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
180 <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="returnvalue">GAppInfo</span></a> * <a class="link" href="GFile.html#g-file-query-default-handler" title="g_file_query_default_handler ()">g_file_query_default_handler</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
181 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
182 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
183 <a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> * <a class="link" href="GFile.html#g-file-find-enclosing-mount" title="g_file_find_enclosing_mount ()">g_file_find_enclosing_mount</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
184 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
185 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
186 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-find-enclosing-mount-async" title="g_file_find_enclosing_mount_async ()">g_file_find_enclosing_mount_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
187 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
188 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
189 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
190 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
191 <a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> * <a class="link" href="GFile.html#g-file-find-enclosing-mount-finish" title="g_file_find_enclosing_mount_finish ()">g_file_find_enclosing_mount_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
192 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
193 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
194 <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> * <a class="link" href="GFile.html#g-file-enumerate-children" title="g_file_enumerate_children ()">g_file_enumerate_children</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
195 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
196 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
197 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
198 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
199 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-enumerate-children-async" title="g_file_enumerate_children_async ()">g_file_enumerate_children_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
200 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
201 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
202 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
203 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
204 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
205 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
206 <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> * <a class="link" href="GFile.html#g-file-enumerate-children-finish" title="g_file_enumerate_children_finish ()">g_file_enumerate_children_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
207 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
208 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
209 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-set-display-name" title="g_file_set_display_name ()">g_file_set_display_name</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
210 <em class="parameter"><code>const <span class="type">char</span> *display_name</code></em>,
211 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
212 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
213 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-set-display-name-async" title="g_file_set_display_name_async ()">g_file_set_display_name_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
214 <em class="parameter"><code>const <span class="type">char</span> *display_name</code></em>,
215 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
216 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
217 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
218 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
219 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-set-display-name-finish" title="g_file_set_display_name_finish ()">g_file_set_display_name_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
220 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
221 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
222 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-delete" title="g_file_delete ()">g_file_delete</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
223 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
224 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
225 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-trash" title="g_file_trash ()">g_file_trash</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
226 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
227 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
228 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()">g_file_copy</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
229 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
230 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
231 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
232 <em class="parameter"><code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> progress_callback</code></em>,
233 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_callback_data</code></em>,
234 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
235 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-copy-async" title="g_file_copy_async ()">g_file_copy_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
236 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
237 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
238 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
239 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
240 <em class="parameter"><code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> progress_callback</code></em>,
241 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_callback_data</code></em>,
242 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
243 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
244 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-copy-finish" title="g_file_copy_finish ()">g_file_copy_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
245 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
246 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
247 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-move" title="g_file_move ()">g_file_move</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
248 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
249 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
250 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
251 <em class="parameter"><code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> progress_callback</code></em>,
252 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_callback_data</code></em>,
253 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
254 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-make-directory" title="g_file_make_directory ()">g_file_make_directory</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
255 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
256 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
257 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-make-directory-with-parents" title="g_file_make_directory_with_parents ()">g_file_make_directory_with_parents</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
258 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
259 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
260 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-make-symbolic-link" title="g_file_make_symbolic_link ()">g_file_make_symbolic_link</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
261 <em class="parameter"><code>const <span class="type">char</span> *symlink_value</code></em>,
262 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
263 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
264 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * <a class="link" href="GFile.html#g-file-query-settable-attributes" title="g_file_query_settable_attributes ()">g_file_query_settable_attributes</a>
265 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
266 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
267 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
268 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * <a class="link" href="GFile.html#g-file-query-writable-namespaces" title="g_file_query_writable_namespaces ()">g_file_query_writable_namespaces</a>
269 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
270 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
271 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
272 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute" title="g_file_set_attribute ()">g_file_set_attribute</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
273 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
274 <em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> type</code></em>,
275 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> value_p</code></em>,
276 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
277 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
278 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
279 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attributes-from-info" title="g_file_set_attributes_from_info ()">g_file_set_attributes_from_info</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
280 <em class="parameter"><code><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> *info</code></em>,
281 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
282 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
283 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
284 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-set-attributes-async" title="g_file_set_attributes_async ()">g_file_set_attributes_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
285 <em class="parameter"><code><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> *info</code></em>,
286 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
287 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
288 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
289 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
290 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
291 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attributes-finish" title="g_file_set_attributes_finish ()">g_file_set_attributes_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
292 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
293 <em class="parameter"><code><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> **info</code></em>,
294 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
295 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute-string" title="g_file_set_attribute_string ()">g_file_set_attribute_string</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
296 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
297 <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
298 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
299 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
300 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
301 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute-byte-string" title="g_file_set_attribute_byte_string ()">g_file_set_attribute_byte_string</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
302 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
303 <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
304 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
305 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
306 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
307 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute-uint32" title="g_file_set_attribute_uint32 ()">g_file_set_attribute_uint32</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
308 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
309 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>,
310 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
311 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
312 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
313 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute-int32" title="g_file_set_attribute_int32 ()">g_file_set_attribute_int32</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
314 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
315 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> value</code></em>,
316 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
317 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
318 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
319 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute-uint64" title="g_file_set_attribute_uint64 ()">g_file_set_attribute_uint64</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
320 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
321 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> value</code></em>,
322 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
323 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
324 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
325 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-set-attribute-int64" title="g_file_set_attribute_int64 ()">g_file_set_attribute_int64</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
326 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
327 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> value</code></em>,
328 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
329 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
330 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
331 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-mount-mountable" title="g_file_mount_mountable ()">g_file_mount_mountable</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
332 <em class="parameter"><code><a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags"><span class="type">GMountMountFlags</span></a> flags</code></em>,
333 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
334 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
335 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
336 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
337 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFile.html#g-file-mount-mountable-finish" title="g_file_mount_mountable_finish ()">g_file_mount_mountable_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
338 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
339 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
340 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-unmount-mountable" title="g_file_unmount_mountable ()">g_file_unmount_mountable</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
341 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
342 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
343 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
344 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
345 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-unmount-mountable-finish" title="g_file_unmount_mountable_finish ()">g_file_unmount_mountable_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
346 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
347 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
348 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()">g_file_unmount_mountable_with_operation</a>
349 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
350 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
351 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
352 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
353 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
354 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
355 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation-finish" title="g_file_unmount_mountable_with_operation_finish ()">g_file_unmount_mountable_with_operation_finish</a>
356 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
357 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
358 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
359 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-eject-mountable" title="g_file_eject_mountable ()">g_file_eject_mountable</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
360 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
361 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
362 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
363 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
364 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-eject-mountable-finish" title="g_file_eject_mountable_finish ()">g_file_eject_mountable_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
365 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
366 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
367 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-eject-mountable-with-operation" title="g_file_eject_mountable_with_operation ()">g_file_eject_mountable_with_operation</a>
368 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
369 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
370 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
371 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
372 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
373 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
374 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-eject-mountable-with-operation-finish" title="g_file_eject_mountable_with_operation_finish ()">g_file_eject_mountable_with_operation_finish</a>
375 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
376 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
377 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
378 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-start-mountable" title="g_file_start_mountable ()">g_file_start_mountable</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
379 <em class="parameter"><code><a class="link" href="GDrive.html#GDriveStartFlags" title="enum GDriveStartFlags"><span class="type">GDriveStartFlags</span></a> flags</code></em>,
380 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *start_operation</code></em>,
381 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
382 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
383 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
384 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-start-mountable-finish" title="g_file_start_mountable_finish ()">g_file_start_mountable_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
385 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
386 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
387 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-stop-mountable" title="g_file_stop_mountable ()">g_file_stop_mountable</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
388 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
389 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
390 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
391 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
392 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
393 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-stop-mountable-finish" title="g_file_stop_mountable_finish ()">g_file_stop_mountable_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
394 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
395 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
396 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-poll-mountable" title="g_file_poll_mountable ()">g_file_poll_mountable</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
397 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
398 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
399 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
400 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-poll-mountable-finish" title="g_file_poll_mountable_finish ()">g_file_poll_mountable_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
401 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
402 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
403 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-mount-enclosing-volume" title="g_file_mount_enclosing_volume ()">g_file_mount_enclosing_volume</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *location</code></em>,
404 <em class="parameter"><code><a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags"><span class="type">GMountMountFlags</span></a> flags</code></em>,
405 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
406 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
407 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
408 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
409 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-mount-enclosing-volume-finish" title="g_file_mount_enclosing_volume_finish ()">g_file_mount_enclosing_volume_finish</a>
410 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *location</code></em>,
411 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
412 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
413 <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="returnvalue">GFileMonitor</span></a> * <a class="link" href="GFile.html#g-file-monitor-directory" title="g_file_monitor_directory ()">g_file_monitor_directory</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
414 <em class="parameter"><code><a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a> flags</code></em>,
415 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
416 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
417 <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="returnvalue">GFileMonitor</span></a> * <a class="link" href="GFile.html#g-file-monitor-file" title="g_file_monitor_file ()">g_file_monitor_file</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
418 <em class="parameter"><code><a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a> flags</code></em>,
419 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
420 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
421 <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="returnvalue">GFileMonitor</span></a> * <a class="link" href="GFile.html#g-file-monitor" title="g_file_monitor ()">g_file_monitor</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
422 <em class="parameter"><code><a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a> flags</code></em>,
423 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
424 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
425 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-load-contents" title="g_file_load_contents ()">g_file_load_contents</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
426 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
427 <em class="parameter"><code><span class="type">char</span> **contents</code></em>,
428 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
429 <em class="parameter"><code><span class="type">char</span> **etag_out</code></em>,
430 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
431 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-load-contents-async" title="g_file_load_contents_async ()">g_file_load_contents_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
432 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
433 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
434 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
435 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-load-contents-finish" title="g_file_load_contents_finish ()">g_file_load_contents_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
436 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
437 <em class="parameter"><code><span class="type">char</span> **contents</code></em>,
438 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
439 <em class="parameter"><code><span class="type">char</span> **etag_out</code></em>,
440 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
441 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-load-partial-contents-async" title="g_file_load_partial_contents_async ()">g_file_load_partial_contents_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
442 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
443 <em class="parameter"><code><a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()"><span class="type">GFileReadMoreCallback</span></a> read_more_callback</code></em>,
444 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
445 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
446 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-load-partial-contents-finish" title="g_file_load_partial_contents_finish ()">g_file_load_partial_contents_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
447 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
448 <em class="parameter"><code><span class="type">char</span> **contents</code></em>,
449 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
450 <em class="parameter"><code><span class="type">char</span> **etag_out</code></em>,
451 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
452 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-replace-contents" title="g_file_replace_contents ()">g_file_replace_contents</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
453 <em class="parameter"><code>const <span class="type">char</span> *contents</code></em>,
454 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
455 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
456 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
457 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
458 <em class="parameter"><code><span class="type">char</span> **new_etag</code></em>,
459 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
460 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
461 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-replace-contents-async" title="g_file_replace_contents_async ()">g_file_replace_contents_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
462 <em class="parameter"><code>const <span class="type">char</span> *contents</code></em>,
463 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
464 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
465 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
466 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
467 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
468 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
469 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
470 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-replace-contents-finish" title="g_file_replace_contents_finish ()">g_file_replace_contents_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
471 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
472 <em class="parameter"><code><span class="type">char</span> **new_etag</code></em>,
473 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
474 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-copy-attributes" title="g_file_copy_attributes ()">g_file_copy_attributes</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
475 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
476 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
477 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
478 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
479 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * <a class="link" href="GFile.html#g-file-create-readwrite" title="g_file_create_readwrite ()">g_file_create_readwrite</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
480 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
481 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
482 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
483 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-create-readwrite-async" title="g_file_create_readwrite_async ()">g_file_create_readwrite_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
484 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
485 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
486 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
487 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
488 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
489 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * <a class="link" href="GFile.html#g-file-create-readwrite-finish" title="g_file_create_readwrite_finish ()">g_file_create_readwrite_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
490 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
491 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
492 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * <a class="link" href="GFile.html#g-file-open-readwrite" title="g_file_open_readwrite ()">g_file_open_readwrite</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
493 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
494 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
495 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-open-readwrite-async" title="g_file_open_readwrite_async ()">g_file_open_readwrite_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
496 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
497 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
498 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
499 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
500 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * <a class="link" href="GFile.html#g-file-open-readwrite-finish" title="g_file_open_readwrite_finish ()">g_file_open_readwrite_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
501 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
502 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
503 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * <a class="link" href="GFile.html#g-file-replace-readwrite" title="g_file_replace_readwrite ()">g_file_replace_readwrite</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
504 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
505 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
506 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
507 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
508 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
509 <span class="returnvalue">void</span> <a class="link" href="GFile.html#g-file-replace-readwrite-async" title="g_file_replace_readwrite_async ()">g_file_replace_readwrite_async</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
510 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
511 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
512 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
513 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
514 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
515 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
516 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
517 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * <a class="link" href="GFile.html#g-file-replace-readwrite-finish" title="g_file_replace_readwrite_finish ()">g_file_replace_readwrite_finish</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
518 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
519 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
520 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFile.html#g-file-supports-thread-contexts" title="g_file_supports_thread_contexts ()">g_file_supports_thread_contexts</a> (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);
523 <div class="refsect1">
524 <a name="GFile.object-hierarchy"></a><h2>Object Hierarchy</h2>
525 <pre class="synopsis">
529 <pre class="synopsis">
531 +----GFileMonitorFlags
534 <div class="refsect1">
535 <a name="GFile.prerequisites"></a><h2>Prerequisites</h2>
538 <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
540 <div class="refsect1">
541 <a name="GFile.description"></a><h2>Description</h2>
543 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> is a high level abstraction for manipulating files on a
544 virtual file system. <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s are lightweight, immutable
545 objects that do no I/O upon creation. It is necessary to understand that
546 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> objects do not represent files, merely an identifier for a file. All
547 file content I/O is implemented as streaming operations (see <a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> and
548 <a class="link" href="GOutputStream.html" title="GOutputStream"><span class="type">GOutputStream</span></a>).
551 To construct a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, you can use:
552 <a class="link" href="GFile.html#g-file-new-for-path" title="g_file_new_for_path ()"><code class="function">g_file_new_for_path()</code></a> if you have a path.
553 <a class="link" href="GFile.html#g-file-new-for-uri" title="g_file_new_for_uri ()"><code class="function">g_file_new_for_uri()</code></a> if you have a URI.
554 <a class="link" href="GFile.html#g-file-new-for-commandline-arg" title="g_file_new_for_commandline_arg ()"><code class="function">g_file_new_for_commandline_arg()</code></a> for a command line argument.
555 <a class="link" href="GFile.html#g-file-new-tmp" title="g_file_new_tmp ()"><code class="function">g_file_new_tmp()</code></a> to create a temporary file from a template.
556 <a class="link" href="GFile.html#g-file-parse-name" title="g_file_parse_name ()"><code class="function">g_file_parse_name()</code></a> from a utf8 string gotten from <a class="link" href="GFile.html#g-file-get-parse-name" title="g_file_get_parse_name ()"><code class="function">g_file_get_parse_name()</code></a>.
559 One way to think of a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> is as an abstraction of a pathname. For normal
560 files the system pathname is what is stored internally, but as <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s
561 are extensible it could also be something else that corresponds to a pathname
562 in a userspace implementation of a filesystem.
565 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s make up hierarchies of directories and files that correspond to the
566 files on a filesystem. You can move through the file system with <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> using
567 <a class="link" href="GFile.html#g-file-get-parent" title="g_file_get_parent ()"><code class="function">g_file_get_parent()</code></a> to get an identifier for the parent directory, <a class="link" href="GFile.html#g-file-get-child" title="g_file_get_child ()"><code class="function">g_file_get_child()</code></a>
568 to get a child within a directory, <a class="link" href="GFile.html#g-file-resolve-relative-path" title="g_file_resolve_relative_path ()"><code class="function">g_file_resolve_relative_path()</code></a> to resolve a relative
569 path between two <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s. There can be multiple hierarchies, so you may not
570 end up at the same root if you repeatedly call <a class="link" href="GFile.html#g-file-get-parent" title="g_file_get_parent ()"><code class="function">g_file_get_parent()</code></a> on two different
574 All <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s have a basename (get with <a class="link" href="GFile.html#g-file-get-basename" title="g_file_get_basename ()"><code class="function">g_file_get_basename()</code></a>). These names
575 are byte strings that are used to identify the file on the filesystem (relative to
576 its parent directory) and there is no guarantees that they have any particular charset
577 encoding or even make any sense at all. If you want to use filenames in a user
578 interface you should use the display name that you can get by requesting the
579 <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-DISPLAY-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME</code></a> attribute with <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a>.
580 This is guaranteed to be in utf8 and can be used in a user interface. But always
581 store the real basename or the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to use to actually access the file, because
582 there is no way to go from a display name to the actual name.
585 Using <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> as an identifier has the same weaknesses as using a path in that
586 there may be multiple aliases for the same file. For instance, hard or
587 soft links may cause two different <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s to refer to the same file.
588 Other possible causes for aliases are: case insensitive filesystems, short
589 and long names on Fat/NTFS, or bind mounts in Linux. If you want to check if
590 two <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s point to the same file you can query for the
591 <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ID-FILE:CAPS" title="G_FILE_ATTRIBUTE_ID_FILE"><code class="literal">G_FILE_ATTRIBUTE_ID_FILE</code></a> attribute. Note that <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> does some trivial
592 canonicalization of pathnames passed in, so that trivial differences in the
593 path string used at creation (duplicated slashes, slash at end of path, "."
594 or ".." path segments, etc) does not create different <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s.
597 Many <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> operations have both synchronous and asynchronous versions
598 to suit your application. Asynchronous versions of synchronous functions
599 simply have <a class="link" href="async.html" title="Asynchronous I/O"><code class="function">_async()</code></a> appended to their function names. The asynchronous
600 I/O functions call a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> which is then used to finalize
601 the operation, producing a GAsyncResult which is then passed to the
602 function's matching <code class="function">_finish()</code> operation.
605 Some <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> operations do not have synchronous analogs, as they may
606 take a very long time to finish, and blocking may leave an application
607 unusable. Notable cases include:
608 <a class="link" href="GFile.html#g-file-mount-mountable" title="g_file_mount_mountable ()"><code class="function">g_file_mount_mountable()</code></a> to mount a mountable file.
609 <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()"><code class="function">g_file_unmount_mountable_with_operation()</code></a> to unmount a mountable file.
610 <a class="link" href="GFile.html#g-file-eject-mountable-with-operation" title="g_file_eject_mountable_with_operation ()"><code class="function">g_file_eject_mountable_with_operation()</code></a> to eject a mountable file.
614 <p><a name="gfile-etag"></a>
615 One notable feature of <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s are entity tags, or "etags" for
616 short. Entity tags are somewhat like a more abstract version of the
617 traditional mtime, and can be used to quickly determine if the file has
618 been modified from the version on the file system. See the HTTP 1.1
619 <a class="ulink" href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html" target="_top">specification</a>
620 for HTTP Etag headers, which are a very similar concept.
625 <div class="refsect1">
626 <a name="GFile.details"></a><h2>Details</h2>
627 <div class="refsect2">
628 <a name="GFile-struct"></a><h3>GFile</h3>
629 <pre class="programlisting">typedef struct _GFile GFile;</pre>
631 A handle to an object implementing the <a class="link" href="GFile.html#GFileIface" title="struct GFileIface"><span class="type">GFileIface</span></a> interface.
632 Generally stores a location within the file system. Handles do not
633 necessarily represent files or directories that currently exist.
637 <div class="refsect2">
638 <a name="GFileIface"></a><h3>struct GFileIface</h3>
639 <pre class="programlisting">struct GFileIface {
640 GTypeInterface g_iface;
644 GFile * (* dup) (GFile *file);
645 guint (* hash) (GFile *file);
646 gboolean (* equal) (GFile *file1,
648 gboolean (* is_native) (GFile *file);
649 gboolean (* has_uri_scheme) (GFile *file,
650 const char *uri_scheme);
651 char * (* get_uri_scheme) (GFile *file);
652 char * (* get_basename) (GFile *file);
653 char * (* get_path) (GFile *file);
654 char * (* get_uri) (GFile *file);
655 char * (* get_parse_name) (GFile *file);
656 GFile * (* get_parent) (GFile *file);
657 gboolean (* prefix_matches) (GFile *prefix,
659 char * (* get_relative_path) (GFile *parent,
661 GFile * (* resolve_relative_path) (GFile *file,
662 const char *relative_path);
663 GFile * (* get_child_for_display_name) (GFile *file,
664 const char *display_name,
667 GFileEnumerator * (* enumerate_children) (GFile *file,
668 const char *attributes,
669 GFileQueryInfoFlags flags,
670 GCancellable *cancellable,
672 void (* enumerate_children_async) (GFile *file,
673 const char *attributes,
674 GFileQueryInfoFlags flags,
676 GCancellable *cancellable,
677 GAsyncReadyCallback callback,
679 GFileEnumerator * (* enumerate_children_finish) (GFile *file,
683 GFileInfo * (* query_info) (GFile *file,
684 const char *attributes,
685 GFileQueryInfoFlags flags,
686 GCancellable *cancellable,
688 void (* query_info_async) (GFile *file,
689 const char *attributes,
690 GFileQueryInfoFlags flags,
692 GCancellable *cancellable,
693 GAsyncReadyCallback callback,
695 GFileInfo * (* query_info_finish) (GFile *file,
699 GFileInfo * (* query_filesystem_info) (GFile *file,
700 const char *attributes,
701 GCancellable *cancellable,
703 void (* query_filesystem_info_async) (GFile *file,
704 const char *attributes,
706 GCancellable *cancellable,
707 GAsyncReadyCallback callback,
709 GFileInfo * (* query_filesystem_info_finish)(GFile *file,
713 GMount * (* find_enclosing_mount) (GFile *file,
714 GCancellable *cancellable,
716 void (* find_enclosing_mount_async) (GFile *file,
718 GCancellable *cancellable,
719 GAsyncReadyCallback callback,
721 GMount * (* find_enclosing_mount_finish) (GFile *file,
725 GFile * (* set_display_name) (GFile *file,
726 const char *display_name,
727 GCancellable *cancellable,
729 void (* set_display_name_async) (GFile *file,
730 const char *display_name,
732 GCancellable *cancellable,
733 GAsyncReadyCallback callback,
735 GFile * (* set_display_name_finish) (GFile *file,
739 GFileAttributeInfoList * (* query_settable_attributes) (GFile *file,
740 GCancellable *cancellable,
742 void (* _query_settable_attributes_async) (void);
743 void (* _query_settable_attributes_finish) (void);
745 GFileAttributeInfoList * (* query_writable_namespaces) (GFile *file,
746 GCancellable *cancellable,
748 void (* _query_writable_namespaces_async) (void);
749 void (* _query_writable_namespaces_finish) (void);
751 gboolean (* set_attribute) (GFile *file,
752 const char *attribute,
753 GFileAttributeType type,
755 GFileQueryInfoFlags flags,
756 GCancellable *cancellable,
758 gboolean (* set_attributes_from_info) (GFile *file,
760 GFileQueryInfoFlags flags,
761 GCancellable *cancellable,
763 void (* set_attributes_async) (GFile *file,
765 GFileQueryInfoFlags flags,
767 GCancellable *cancellable,
768 GAsyncReadyCallback callback,
770 gboolean (* set_attributes_finish) (GFile *file,
771 GAsyncResult *result,
775 GFileInputStream * (* read_fn) (GFile *file,
776 GCancellable *cancellable,
778 void (* read_async) (GFile *file,
780 GCancellable *cancellable,
781 GAsyncReadyCallback callback,
783 GFileInputStream * (* read_finish) (GFile *file,
787 GFileOutputStream * (* append_to) (GFile *file,
788 GFileCreateFlags flags,
789 GCancellable *cancellable,
791 void (* append_to_async) (GFile *file,
792 GFileCreateFlags flags,
794 GCancellable *cancellable,
795 GAsyncReadyCallback callback,
797 GFileOutputStream * (* append_to_finish) (GFile *file,
801 GFileOutputStream * (* create) (GFile *file,
802 GFileCreateFlags flags,
803 GCancellable *cancellable,
805 void (* create_async) (GFile *file,
806 GFileCreateFlags flags,
808 GCancellable *cancellable,
809 GAsyncReadyCallback callback,
811 GFileOutputStream * (* create_finish) (GFile *file,
815 GFileOutputStream * (* replace) (GFile *file,
817 gboolean make_backup,
818 GFileCreateFlags flags,
819 GCancellable *cancellable,
821 void (* replace_async) (GFile *file,
823 gboolean make_backup,
824 GFileCreateFlags flags,
826 GCancellable *cancellable,
827 GAsyncReadyCallback callback,
829 GFileOutputStream * (* replace_finish) (GFile *file,
833 gboolean (* delete_file) (GFile *file,
834 GCancellable *cancellable,
836 void (* _delete_file_async) (void);
837 void (* _delete_file_finish) (void);
839 gboolean (* trash) (GFile *file,
840 GCancellable *cancellable,
842 void (* _trash_async) (void);
843 void (* _trash_finish) (void);
845 gboolean (* make_directory) (GFile *file,
846 GCancellable *cancellable,
848 void (* _make_directory_async) (void);
849 void (* _make_directory_finish) (void);
851 gboolean (* make_symbolic_link) (GFile *file,
852 const char *symlink_value,
853 GCancellable *cancellable,
855 void (* _make_symbolic_link_async) (void);
856 void (* _make_symbolic_link_finish) (void);
858 gboolean (* copy) (GFile *source,
860 GFileCopyFlags flags,
861 GCancellable *cancellable,
862 GFileProgressCallback progress_callback,
863 gpointer progress_callback_data,
865 void (* copy_async) (GFile *source,
867 GFileCopyFlags flags,
869 GCancellable *cancellable,
870 GFileProgressCallback progress_callback,
871 gpointer progress_callback_data,
872 GAsyncReadyCallback callback,
874 gboolean (* copy_finish) (GFile *file,
878 gboolean (* move) (GFile *source,
880 GFileCopyFlags flags,
881 GCancellable *cancellable,
882 GFileProgressCallback progress_callback,
883 gpointer progress_callback_data,
885 void (* _move_async) (void);
886 void (* _move_finish) (void);
888 void (* mount_mountable) (GFile *file,
889 GMountMountFlags flags,
890 GMountOperation *mount_operation,
891 GCancellable *cancellable,
892 GAsyncReadyCallback callback,
894 GFile * (* mount_mountable_finish) (GFile *file,
895 GAsyncResult *result,
898 void (* unmount_mountable) (GFile *file,
899 GMountUnmountFlags flags,
900 GCancellable *cancellable,
901 GAsyncReadyCallback callback,
903 gboolean (* unmount_mountable_finish) (GFile *file,
904 GAsyncResult *result,
907 void (* eject_mountable) (GFile *file,
908 GMountUnmountFlags flags,
909 GCancellable *cancellable,
910 GAsyncReadyCallback callback,
912 gboolean (* eject_mountable_finish) (GFile *file,
913 GAsyncResult *result,
916 void (* mount_enclosing_volume) (GFile *location,
917 GMountMountFlags flags,
918 GMountOperation *mount_operation,
919 GCancellable *cancellable,
920 GAsyncReadyCallback callback,
922 gboolean (* mount_enclosing_volume_finish) (GFile *location,
923 GAsyncResult *result,
926 GFileMonitor * (* monitor_dir) (GFile *file,
927 GFileMonitorFlags flags,
928 GCancellable *cancellable,
930 GFileMonitor * (* monitor_file) (GFile *file,
931 GFileMonitorFlags flags,
932 GCancellable *cancellable,
935 GFileIOStream * (* open_readwrite) (GFile *file,
936 GCancellable *cancellable,
938 void (* open_readwrite_async) (GFile *file,
940 GCancellable *cancellable,
941 GAsyncReadyCallback callback,
943 GFileIOStream * (* open_readwrite_finish) (GFile *file,
946 GFileIOStream * (* create_readwrite) (GFile *file,
947 GFileCreateFlags flags,
948 GCancellable *cancellable,
950 void (* create_readwrite_async) (GFile *file,
951 GFileCreateFlags flags,
953 GCancellable *cancellable,
954 GAsyncReadyCallback callback,
956 GFileIOStream * (* create_readwrite_finish) (GFile *file,
959 GFileIOStream * (* replace_readwrite) (GFile *file,
961 gboolean make_backup,
962 GFileCreateFlags flags,
963 GCancellable *cancellable,
965 void (* replace_readwrite_async) (GFile *file,
967 gboolean make_backup,
968 GFileCreateFlags flags,
970 GCancellable *cancellable,
971 GAsyncReadyCallback callback,
973 GFileIOStream * (* replace_readwrite_finish) (GFile *file,
977 void (* start_mountable) (GFile *file,
978 GDriveStartFlags flags,
979 GMountOperation *start_operation,
980 GCancellable *cancellable,
981 GAsyncReadyCallback callback,
983 gboolean (* start_mountable_finish) (GFile *file,
984 GAsyncResult *result,
987 void (* stop_mountable) (GFile *file,
988 GMountUnmountFlags flags,
989 GMountOperation *mount_operation,
990 GCancellable *cancellable,
991 GAsyncReadyCallback callback,
993 gboolean (* stop_mountable_finish) (GFile *file,
994 GAsyncResult *result,
997 gboolean supports_thread_contexts;
999 void (* unmount_mountable_with_operation) (GFile *file,
1000 GMountUnmountFlags flags,
1001 GMountOperation *mount_operation,
1002 GCancellable *cancellable,
1003 GAsyncReadyCallback callback,
1004 gpointer user_data);
1005 gboolean (* unmount_mountable_with_operation_finish) (GFile *file,
1006 GAsyncResult *result,
1009 void (* eject_mountable_with_operation) (GFile *file,
1010 GMountUnmountFlags flags,
1011 GMountOperation *mount_operation,
1012 GCancellable *cancellable,
1013 GAsyncReadyCallback callback,
1014 gpointer user_data);
1015 gboolean (* eject_mountable_with_operation_finish) (GFile *file,
1016 GAsyncResult *result,
1019 void (* poll_mountable) (GFile *file,
1020 GCancellable *cancellable,
1021 GAsyncReadyCallback callback,
1022 gpointer user_data);
1023 gboolean (* poll_mountable_finish) (GFile *file,
1024 GAsyncResult *result,
1029 An interface for writing VFS file handles.
1031 <div class="variablelist"><table border="0">
1032 <col align="left" valign="top">
1035 <td><p><span class="term"><a href="./../gobject/gobject/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GFileIface.g-iface"></a>g_iface</code></em>;</span></p></td>
1036 <td>The parent interface.</td>
1039 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.dup"></a>dup</code></em> ()</span></p></td>
1040 <td>Duplicates a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1043 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.hash"></a>hash</code></em> ()</span></p></td>
1044 <td>Creates a hash of a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1047 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.equal"></a>equal</code></em> ()</span></p></td>
1048 <td>Checks equality of two given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s.</td>
1051 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.is-native"></a>is_native</code></em> ()</span></p></td>
1052 <td>Checks to see if a file is native to the system.</td>
1055 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.has-uri-scheme"></a>has_uri_scheme</code></em> ()</span></p></td>
1056 <td>Checks to see if a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> has a given URI scheme.</td>
1059 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-uri-scheme"></a>get_uri_scheme</code></em> ()</span></p></td>
1060 <td>Gets the URI scheme for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1063 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-basename"></a>get_basename</code></em> ()</span></p></td>
1064 <td>Gets the basename for a given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1067 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-path"></a>get_path</code></em> ()</span></p></td>
1068 <td>Gets the current path within a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1071 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-uri"></a>get_uri</code></em> ()</span></p></td>
1072 <td>Gets a URI for the path within a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1075 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-parse-name"></a>get_parse_name</code></em> ()</span></p></td>
1076 <td>Gets the parsed name for the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1079 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-parent"></a>get_parent</code></em> ()</span></p></td>
1080 <td>Gets the parent directory for the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1083 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.prefix-matches"></a>prefix_matches</code></em> ()</span></p></td>
1084 <td>Checks whether a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> contains a specified file.</td>
1087 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-relative-path"></a>get_relative_path</code></em> ()</span></p></td>
1088 <td>Gets the path for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> relative to a given path.</td>
1091 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.resolve-relative-path"></a>resolve_relative_path</code></em> ()</span></p></td>
1092 <td>Resolves a relative path for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to an absolute path.</td>
1095 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.get-child-for-display-name"></a>get_child_for_display_name</code></em> ()</span></p></td>
1096 <td>Gets the child <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> for a given display name.</td>
1099 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.enumerate-children"></a>enumerate_children</code></em> ()</span></p></td>
1100 <td>Gets a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a> with the children of a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1103 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.enumerate-children-async"></a>enumerate_children_async</code></em> ()</span></p></td>
1104 <td>Asynchronously gets a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a> with the children of a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1107 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.enumerate-children-finish"></a>enumerate_children_finish</code></em> ()</span></p></td>
1108 <td>Finishes asynchronously enumerating the children.</td>
1111 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-info"></a>query_info</code></em> ()</span></p></td>
1112 <td>Gets the <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1115 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-info-async"></a>query_info_async</code></em> ()</span></p></td>
1116 <td>Asynchronously gets the <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1119 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-info-finish"></a>query_info_finish</code></em> ()</span></p></td>
1120 <td>Finishes an asynchronous query info operation.</td>
1123 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-filesystem-info"></a>query_filesystem_info</code></em> ()</span></p></td>
1124 <td>Gets a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for the file system <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> is on.</td>
1127 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-filesystem-info-async"></a>query_filesystem_info_async</code></em> ()</span></p></td>
1128 <td>Asynchronously gets a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for the file system <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> is on.</td>
1131 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-filesystem-info-finish"></a>query_filesystem_info_finish</code></em> ()</span></p></td>
1132 <td>Finishes asynchronously getting the file system info.</td>
1135 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.find-enclosing-mount"></a>find_enclosing_mount</code></em> ()</span></p></td>
1136 <td>Gets a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> for the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1139 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.find-enclosing-mount-async"></a>find_enclosing_mount_async</code></em> ()</span></p></td>
1140 <td>Asynchronously gets the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1143 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.find-enclosing-mount-finish"></a>find_enclosing_mount_finish</code></em> ()</span></p></td>
1144 <td>Finishes asynchronously getting the volume.</td>
1147 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-display-name"></a>set_display_name</code></em> ()</span></p></td>
1148 <td>Sets the display name for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1151 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-display-name-async"></a>set_display_name_async</code></em> ()</span></p></td>
1152 <td>Asynchronously sets a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s display name.</td>
1155 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-display-name-finish"></a>set_display_name_finish</code></em> ()</span></p></td>
1156 <td>Finishes asynchronously setting a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s display name.</td>
1159 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-settable-attributes"></a>query_settable_attributes</code></em> ()</span></p></td>
1160 <td>Returns a list of <span class="type">GFileAttribute</span>s that can be set.</td>
1163 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-query-settable-attributes-async"></a>_query_settable_attributes_async</code></em> ()</span></p></td>
1164 <td>Asynchronously gets a list of <span class="type">GFileAttribute</span>s that can be set.</td>
1167 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-query-settable-attributes-finish"></a>_query_settable_attributes_finish</code></em> ()</span></p></td>
1168 <td>Finishes asynchronously querying settable attributes.</td>
1171 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.query-writable-namespaces"></a>query_writable_namespaces</code></em> ()</span></p></td>
1172 <td>Returns a list of <span class="type">GFileAttribute</span> namespaces that are writable.</td>
1175 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-query-writable-namespaces-async"></a>_query_writable_namespaces_async</code></em> ()</span></p></td>
1176 <td>Asynchronously gets a list of <span class="type">GFileAttribute</span> namespaces that are writable.</td>
1179 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-query-writable-namespaces-finish"></a>_query_writable_namespaces_finish</code></em> ()</span></p></td>
1180 <td>Finishes asynchronously querying the writable namespaces.</td>
1183 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-attribute"></a>set_attribute</code></em> ()</span></p></td>
1184 <td>Sets a <span class="type">GFileAttribute</span>.</td>
1187 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-attributes-from-info"></a>set_attributes_from_info</code></em> ()</span></p></td>
1188 <td>Sets a <span class="type">GFileAttribute</span> with information from a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>.</td>
1191 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-attributes-async"></a>set_attributes_async</code></em> ()</span></p></td>
1192 <td>Asynchronously sets a file's attributes.</td>
1195 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.set-attributes-finish"></a>set_attributes_finish</code></em> ()</span></p></td>
1196 <td>Finishes setting a file's attributes asynchronously.</td>
1199 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.read-fn"></a>read_fn</code></em> ()</span></p></td>
1200 <td>Reads a file asynchronously.</td>
1203 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.read-async"></a>read_async</code></em> ()</span></p></td>
1204 <td>Asynchronously reads a file.</td>
1207 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.read-finish"></a>read_finish</code></em> ()</span></p></td>
1208 <td>Finishes asynchronously reading a file.</td>
1211 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.append-to"></a>append_to</code></em> ()</span></p></td>
1212 <td>Writes to the end of a file.</td>
1215 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.append-to-async"></a>append_to_async</code></em> ()</span></p></td>
1216 <td>Asynchronously writes to the end of a file.</td>
1219 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.append-to-finish"></a>append_to_finish</code></em> ()</span></p></td>
1220 <td>Finishes an asynchronous file append operation.</td>
1223 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.create"></a>create</code></em> ()</span></p></td>
1224 <td>Creates a new file.</td>
1227 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.create-async"></a>create_async</code></em> ()</span></p></td>
1228 <td>Asynchronously creates a file.</td>
1231 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.create-finish"></a>create_finish</code></em> ()</span></p></td>
1232 <td>Finishes asynchronously creating a file.</td>
1235 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.replace"></a>replace</code></em> ()</span></p></td>
1236 <td>Replaces the contents of a file.</td>
1239 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.replace-async"></a>replace_async</code></em> ()</span></p></td>
1240 <td>Asynchronously replaces the contents of a file.</td>
1243 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.replace-finish"></a>replace_finish</code></em> ()</span></p></td>
1244 <td>Finishes asynchronously replacing a file.</td>
1247 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.delete-file"></a>delete_file</code></em> ()</span></p></td>
1248 <td>Deletes a file.</td>
1251 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-delete-file-async"></a>_delete_file_async</code></em> ()</span></p></td>
1252 <td>Asynchronously deletes a file.</td>
1255 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-delete-file-finish"></a>_delete_file_finish</code></em> ()</span></p></td>
1256 <td>Finishes an asynchronous delete.</td>
1259 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.trash"></a>trash</code></em> ()</span></p></td>
1260 <td>Sends a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to the Trash location.</td>
1263 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-trash-async"></a>_trash_async</code></em> ()</span></p></td>
1264 <td>Asynchronously sends a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to the Trash location.</td>
1267 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-trash-finish"></a>_trash_finish</code></em> ()</span></p></td>
1268 <td>Finishes an asynchronous file trashing operation.</td>
1271 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.make-directory"></a>make_directory</code></em> ()</span></p></td>
1272 <td>Makes a directory.</td>
1275 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-make-directory-async"></a>_make_directory_async</code></em> ()</span></p></td>
1276 <td>Asynchronously makes a directory.</td>
1279 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-make-directory-finish"></a>_make_directory_finish</code></em> ()</span></p></td>
1280 <td>Finishes making a directory asynchronously.</td>
1283 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.make-symbolic-link"></a>make_symbolic_link</code></em> ()</span></p></td>
1284 <td>Makes a symbolic link.</td>
1287 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-make-symbolic-link-async"></a>_make_symbolic_link_async</code></em> ()</span></p></td>
1288 <td>Asynchronously makes a symbolic link</td>
1291 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-make-symbolic-link-finish"></a>_make_symbolic_link_finish</code></em> ()</span></p></td>
1292 <td>Finishes making a symbolic link asynchronously.</td>
1295 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.copy"></a>copy</code></em> ()</span></p></td>
1296 <td>Copies a file.</td>
1299 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.copy-async"></a>copy_async</code></em> ()</span></p></td>
1300 <td>Asynchronously copies a file.</td>
1303 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.copy-finish"></a>copy_finish</code></em> ()</span></p></td>
1304 <td>Finishes an asynchronous copy operation.</td>
1307 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.move"></a>move</code></em> ()</span></p></td>
1308 <td>Moves a file.</td>
1311 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-move-async"></a>_move_async</code></em> ()</span></p></td>
1312 <td>Asynchronously moves a file.</td>
1315 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.-move-finish"></a>_move_finish</code></em> ()</span></p></td>
1316 <td>Finishes an asynchronous move operation.</td>
1319 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.mount-mountable"></a>mount_mountable</code></em> ()</span></p></td>
1320 <td>Mounts a mountable object.</td>
1323 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.mount-mountable-finish"></a>mount_mountable_finish</code></em> ()</span></p></td>
1324 <td>Finishes a mounting operation.</td>
1327 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.unmount-mountable"></a>unmount_mountable</code></em> ()</span></p></td>
1328 <td>Unmounts a mountable object.</td>
1331 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.unmount-mountable-finish"></a>unmount_mountable_finish</code></em> ()</span></p></td>
1332 <td>Finishes an unmount operation.</td>
1335 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.eject-mountable"></a>eject_mountable</code></em> ()</span></p></td>
1336 <td>Ejects a mountable.</td>
1339 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.eject-mountable-finish"></a>eject_mountable_finish</code></em> ()</span></p></td>
1340 <td>Finishes an eject operation.</td>
1343 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.mount-enclosing-volume"></a>mount_enclosing_volume</code></em> ()</span></p></td>
1344 <td>Mounts a specified location.</td>
1347 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.mount-enclosing-volume-finish"></a>mount_enclosing_volume_finish</code></em> ()</span></p></td>
1348 <td>Finishes mounting a specified location.</td>
1351 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.monitor-dir"></a>monitor_dir</code></em> ()</span></p></td>
1352 <td>Creates a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> for the location.</td>
1355 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.monitor-file"></a>monitor_file</code></em> ()</span></p></td>
1356 <td>Creates a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> for the location.</td>
1359 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.open-readwrite"></a>open_readwrite</code></em> ()</span></p></td>
1360 <td>Open file read/write. Since 2.22.</td>
1363 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.open-readwrite-async"></a>open_readwrite_async</code></em> ()</span></p></td>
1364 <td>Asynchronously opens file read/write. Since 2.22.</td>
1367 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.open-readwrite-finish"></a>open_readwrite_finish</code></em> ()</span></p></td>
1368 <td>Finishes an asynchronous open read/write. Since 2.22.</td>
1371 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.create-readwrite"></a>create_readwrite</code></em> ()</span></p></td>
1372 <td>Creates file read/write. Since 2.22.</td>
1375 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.create-readwrite-async"></a>create_readwrite_async</code></em> ()</span></p></td>
1376 <td>Asynchronously creates file read/write. Since 2.22.</td>
1379 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.create-readwrite-finish"></a>create_readwrite_finish</code></em> ()</span></p></td>
1380 <td>Finishes an asynchronous creates read/write. Since 2.22.</td>
1383 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.replace-readwrite"></a>replace_readwrite</code></em> ()</span></p></td>
1384 <td>Replaces file read/write. Since 2.22.</td>
1387 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.replace-readwrite-async"></a>replace_readwrite_async</code></em> ()</span></p></td>
1388 <td>Asynchronously replaces file read/write. Since 2.22.</td>
1391 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.replace-readwrite-finish"></a>replace_readwrite_finish</code></em> ()</span></p></td>
1392 <td>Finishes an asynchronous replace read/write. Since 2.22.</td>
1395 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.start-mountable"></a>start_mountable</code></em> ()</span></p></td>
1396 <td>Starts a mountable object. Since 2.22.</td>
1399 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.start-mountable-finish"></a>start_mountable_finish</code></em> ()</span></p></td>
1400 <td>Finishes an start operation. Since 2.22.</td>
1403 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.stop-mountable"></a>stop_mountable</code></em> ()</span></p></td>
1404 <td>Stops a mountable. Since 2.22.</td>
1407 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.stop-mountable-finish"></a>stop_mountable_finish</code></em> ()</span></p></td>
1408 <td>Finishes an stop operation. Since 2.22.</td>
1411 <td><p><span class="term"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> <em class="structfield"><code><a name="GFileIface.supports-thread-contexts"></a>supports_thread_contexts</code></em>;</span></p></td>
1412 <td>a boolean that indicates whether the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> implementation supports thread-default contexts. Since 2.22.</td>
1415 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.unmount-mountable-with-operation"></a>unmount_mountable_with_operation</code></em> ()</span></p></td>
1416 <td>Unmounts a mountable object using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.</td>
1419 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.unmount-mountable-with-operation-finish"></a>unmount_mountable_with_operation_finish</code></em> ()</span></p></td>
1420 <td>Finishes an unmount operation using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.</td>
1423 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.eject-mountable-with-operation"></a>eject_mountable_with_operation</code></em> ()</span></p></td>
1424 <td>Ejects a mountable object using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.</td>
1427 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.eject-mountable-with-operation-finish"></a>eject_mountable_with_operation_finish</code></em> ()</span></p></td>
1428 <td>Finishes an eject operation using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.</td>
1431 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.poll-mountable"></a>poll_mountable</code></em> ()</span></p></td>
1432 <td>Polls a mountable object for media changes. Since 2.22.</td>
1435 <td><p><span class="term"><em class="structfield"><code><a name="GFileIface.poll-mountable-finish"></a>poll_mountable_finish</code></em> ()</span></p></td>
1436 <td>Finishes an poll operation for media changes. Since 2.22.</td>
1442 <div class="refsect2">
1443 <a name="GFileQueryInfoFlags"></a><h3>enum GFileQueryInfoFlags</h3>
1444 <pre class="programlisting">typedef enum {
1445 G_FILE_QUERY_INFO_NONE = 0,
1446 G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS = (1 << 0) /*< nick=nofollow-symlinks >*/
1447 } GFileQueryInfoFlags;
1450 Flags used when querying a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>.
1452 <div class="variablelist"><table border="0">
1453 <col align="left" valign="top">
1456 <td><p><a name="G-FILE-QUERY-INFO-NONE:CAPS"></a><span class="term"><code class="literal">G_FILE_QUERY_INFO_NONE</code></span></p></td>
1461 <td><p><a name="G-FILE-QUERY-INFO-NOFOLLOW-SYMLINKS:CAPS"></a><span class="term"><code class="literal">G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS</code></span></p></td>
1462 <td>Don't follow symlinks.
1469 <div class="refsect2">
1470 <a name="GFileCreateFlags"></a><h3>enum GFileCreateFlags</h3>
1471 <pre class="programlisting">typedef enum {
1472 G_FILE_CREATE_NONE = 0,
1473 G_FILE_CREATE_PRIVATE = (1 << 0),
1474 G_FILE_CREATE_REPLACE_DESTINATION = (1 << 1)
1478 Flags used when an operation may create a file.
1480 <div class="variablelist"><table border="0">
1481 <col align="left" valign="top">
1484 <td><p><a name="G-FILE-CREATE-NONE:CAPS"></a><span class="term"><code class="literal">G_FILE_CREATE_NONE</code></span></p></td>
1489 <td><p><a name="G-FILE-CREATE-PRIVATE:CAPS"></a><span class="term"><code class="literal">G_FILE_CREATE_PRIVATE</code></span></p></td>
1490 <td>Create a file that can only be
1491 accessed by the current user.
1495 <td><p><a name="G-FILE-CREATE-REPLACE-DESTINATION:CAPS"></a><span class="term"><code class="literal">G_FILE_CREATE_REPLACE_DESTINATION</code></span></p></td>
1496 <td>Replace the destination
1497 as if it didn't exist before. Don't try to keep any old
1498 permissions, replace instead of following links. This
1499 is generally useful if you're doing a "copy over"
1500 rather than a "save new version of" replace operation.
1501 You can think of it as "unlink destination" before
1502 writing to it, although the implementation may not
1503 be exactly like that. Since 2.20
1510 <div class="refsect2">
1511 <a name="GFileCopyFlags"></a><h3>enum GFileCopyFlags</h3>
1512 <pre class="programlisting">typedef enum {
1513 G_FILE_COPY_NONE = 0, /*< nick=none >*/
1514 G_FILE_COPY_OVERWRITE = (1 << 0),
1515 G_FILE_COPY_BACKUP = (1 << 1),
1516 G_FILE_COPY_NOFOLLOW_SYMLINKS = (1 << 2),
1517 G_FILE_COPY_ALL_METADATA = (1 << 3),
1518 G_FILE_COPY_NO_FALLBACK_FOR_MOVE = (1 << 4),
1519 G_FILE_COPY_TARGET_DEFAULT_PERMS = (1 << 5)
1523 Flags used when copying or moving files.
1525 <div class="variablelist"><table border="0">
1526 <col align="left" valign="top">
1529 <td><p><a name="G-FILE-COPY-NONE:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_NONE</code></span></p></td>
1534 <td><p><a name="G-FILE-COPY-OVERWRITE:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_OVERWRITE</code></span></p></td>
1535 <td>Overwrite any existing files
1539 <td><p><a name="G-FILE-COPY-BACKUP:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_BACKUP</code></span></p></td>
1540 <td>Make a backup of any existing files.
1544 <td><p><a name="G-FILE-COPY-NOFOLLOW-SYMLINKS:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_NOFOLLOW_SYMLINKS</code></span></p></td>
1545 <td>Don't follow symlinks.
1549 <td><p><a name="G-FILE-COPY-ALL-METADATA:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_ALL_METADATA</code></span></p></td>
1550 <td>Copy all file metadata instead of just default set used for copy (see <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>).
1554 <td><p><a name="G-FILE-COPY-NO-FALLBACK-FOR-MOVE:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_NO_FALLBACK_FOR_MOVE</code></span></p></td>
1555 <td>Don't use copy and delete fallback if native move not supported.
1559 <td><p><a name="G-FILE-COPY-TARGET-DEFAULT-PERMS:CAPS"></a><span class="term"><code class="literal">G_FILE_COPY_TARGET_DEFAULT_PERMS</code></span></p></td>
1560 <td>Leaves target file with default perms, instead of setting the source file perms.
1567 <div class="refsect2">
1568 <a name="GFileMonitorFlags-enum"></a><h3>enum GFileMonitorFlags</h3>
1569 <pre class="programlisting">typedef enum {
1570 G_FILE_MONITOR_NONE = 0,
1571 G_FILE_MONITOR_WATCH_MOUNTS = (1 << 0),
1572 G_FILE_MONITOR_SEND_MOVED = (1 << 1)
1573 } GFileMonitorFlags;
1576 Flags used to set what a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> will watch for.
1578 <div class="variablelist"><table border="0">
1579 <col align="left" valign="top">
1582 <td><p><a name="G-FILE-MONITOR-NONE:CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_NONE</code></span></p></td>
1587 <td><p><a name="G-FILE-MONITOR-WATCH-MOUNTS:CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_WATCH_MOUNTS</code></span></p></td>
1588 <td>Watch for mount events.
1592 <td><p><a name="G-FILE-MONITOR-SEND-MOVED:CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_SEND_MOVED</code></span></p></td>
1593 <td>Pair DELETED and CREATED events caused
1594 by file renames (moves) and send a single G_FILE_MONITOR_EVENT_MOVED
1595 event instead (NB: not supported on all backends; the default
1596 behaviour -without specifying this flag- is to send single DELETED
1597 and CREATED events).
1604 <div class="refsect2">
1605 <a name="GFilesystemPreviewType"></a><h3>enum GFilesystemPreviewType</h3>
1606 <pre class="programlisting">typedef enum {
1607 G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS = 0,
1608 G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL,
1609 G_FILESYSTEM_PREVIEW_TYPE_NEVER
1610 } GFilesystemPreviewType;
1613 Indicates a hint from the file system whether files should be
1614 previewed in a file manager. Returned as the value of the key
1615 <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-USE-PREVIEW:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW"><span class="type">G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW</span></a>.
1617 <div class="variablelist"><table border="0">
1618 <col align="left" valign="top">
1621 <td><p><a name="G-FILESYSTEM-PREVIEW-TYPE-IF-ALWAYS:CAPS"></a><span class="term"><code class="literal">G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS</code></span></p></td>
1622 <td>Only preview files if user has explicitly requested it.
1626 <td><p><a name="G-FILESYSTEM-PREVIEW-TYPE-IF-LOCAL:CAPS"></a><span class="term"><code class="literal">G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL</code></span></p></td>
1627 <td>Preview files if user has requested preview of "local" files.
1631 <td><p><a name="G-FILESYSTEM-PREVIEW-TYPE-NEVER:CAPS"></a><span class="term"><code class="literal">G_FILESYSTEM_PREVIEW_TYPE_NEVER</code></span></p></td>
1632 <td>Never preview files.
1639 <div class="refsect2">
1640 <a name="GFileProgressCallback"></a><h3>GFileProgressCallback ()</h3>
1641 <pre class="programlisting"><span class="returnvalue">void</span> (*GFileProgressCallback) (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> current_num_bytes</code></em>,
1642 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> total_num_bytes</code></em>,
1643 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1645 When doing file operations that may take a while, such as moving
1646 a file or copying a file, a progress callback is used to pass how
1647 far along that operation is to the application.
1649 <div class="variablelist"><table border="0">
1650 <col align="left" valign="top">
1653 <td><p><span class="term"><em class="parameter"><code>current_num_bytes</code></em> :</span></p></td>
1654 <td>the current number of bytes in the operation.</td>
1657 <td><p><span class="term"><em class="parameter"><code>total_num_bytes</code></em> :</span></p></td>
1658 <td>the total number of bytes in the operation.</td>
1661 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1662 <td>user data passed to the callback.</td>
1668 <div class="refsect2">
1669 <a name="GFileReadMoreCallback"></a><h3>GFileReadMoreCallback ()</h3>
1670 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GFileReadMoreCallback) (<em class="parameter"><code>const <span class="type">char</span> *file_contents</code></em>,
1671 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> file_size</code></em>,
1672 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
1674 When loading the partial contents of a file with <a class="link" href="GFile.html#g-file-load-partial-contents-async" title="g_file_load_partial_contents_async ()"><code class="function">g_file_load_partial_contents_async()</code></a>,
1675 it may become necessary to determine if any more data from the file should be loaded.
1676 A <a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()"><span class="type">GFileReadMoreCallback</span></a> function facilitates this by returning <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more data
1677 should be read, or <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1679 <div class="variablelist"><table border="0">
1680 <col align="left" valign="top">
1683 <td><p><span class="term"><em class="parameter"><code>file_contents</code></em> :</span></p></td>
1684 <td>the data as currently read.</td>
1687 <td><p><span class="term"><em class="parameter"><code>file_size</code></em> :</span></p></td>
1688 <td>the size of the data currently read.</td>
1691 <td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
1692 <td>data passed to the callback.</td>
1695 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1697 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more data should be read back. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1703 <div class="refsect2">
1704 <a name="g-file-new-for-path"></a><h3>g_file_new_for_path ()</h3>
1705 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_new_for_path (<em class="parameter"><code>const <span class="type">char</span> *path</code></em>);</pre>
1707 Constructs a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> for a given path. This operation never
1708 fails, but the returned object might not support any I/O
1709 operation if <em class="parameter"><code>path</code></em> is malformed.
1711 <div class="variablelist"><table border="0">
1712 <col align="left" valign="top">
1715 <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
1716 <td>a string containing a relative or absolute path. The string
1717 must be encoded in the glib filename encoding.</td>
1720 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1721 <td>a new <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> for the given <em class="parameter"><code>path</code></em>.
1722 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1729 <div class="refsect2">
1730 <a name="g-file-new-for-uri"></a><h3>g_file_new_for_uri ()</h3>
1731 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_new_for_uri (<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
1733 Constructs a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> for a given URI. This operation never
1734 fails, but the returned object might not support any I/O
1735 operation if <em class="parameter"><code>uri</code></em> is malformed or if the uri type is
1738 <div class="variablelist"><table border="0">
1739 <col align="left" valign="top">
1742 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1743 <td>a UTF8 string containing a URI.</td>
1746 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1747 <td>a new <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> for the given <em class="parameter"><code>uri</code></em>.
1748 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1755 <div class="refsect2">
1756 <a name="g-file-new-for-commandline-arg"></a><h3>g_file_new_for_commandline_arg ()</h3>
1757 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_new_for_commandline_arg (<em class="parameter"><code>const <span class="type">char</span> *arg</code></em>);</pre>
1759 Creates a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> with the given argument from the command line. The value of
1760 <em class="parameter"><code>arg</code></em> can be either a URI, an absolute path or a relative path resolved
1761 relative to the current working directory.
1762 This operation never fails, but the returned object might not support any
1763 I/O operation if <em class="parameter"><code>arg</code></em> points to a malformed path.
1765 <div class="variablelist"><table border="0">
1766 <col align="left" valign="top">
1769 <td><p><span class="term"><em class="parameter"><code>arg</code></em> :</span></p></td>
1770 <td>a command line string.</td>
1773 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1774 <td>a new <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
1775 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1782 <div class="refsect2">
1783 <a name="g-file-new-tmp"></a><h3>g_file_new_tmp ()</h3>
1784 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_new_tmp (<em class="parameter"><code>const <span class="type">char</span> *tmpl</code></em>,
1785 <em class="parameter"><code><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> **iostream</code></em>,
1786 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1788 Opens a file in the preferred directory for temporary files (as
1789 returned by <a href="./../glib/glib/glib-Miscellaneous-Utility-Functions.html#g-get-tmp-dir"><code class="function">g_get_tmp_dir()</code></a>) and returns a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> and
1790 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> pointing to it.
1793 <em class="parameter"><code>tmpl</code></em> should be a string in the GLib file name encoding
1794 containing a sequence of six 'X' characters, and containing no
1795 directory components. If it is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a default template is used.
1798 Unlike the other <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> constructors, this will return <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
1799 a temporary file could not be created.
1801 <div class="variablelist"><table border="0">
1802 <col align="left" valign="top">
1805 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
1806 <td>Template for the file
1807 name, as in <a href="./../glib/glib/glib-File-Utilities.html#g-file-open-tmp"><code class="function">g_file_open_tmp()</code></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for a default template. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1811 <td><p><span class="term"><em class="parameter"><code>iostream</code></em> :</span></p></td>
1812 <td>on return, a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> for the created file. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1816 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1817 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1821 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1822 <td>a new <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
1823 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1828 <p class="since">Since 2.32</p>
1831 <div class="refsect2">
1832 <a name="g-file-parse-name"></a><h3>g_file_parse_name ()</h3>
1833 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_parse_name (<em class="parameter"><code>const <span class="type">char</span> *parse_name</code></em>);</pre>
1835 Constructs a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> with the given <em class="parameter"><code>parse_name</code></em> (i.e. something given by <a class="link" href="GFile.html#g-file-get-parse-name" title="g_file_get_parse_name ()"><code class="function">g_file_get_parse_name()</code></a>).
1836 This operation never fails, but the returned object might not support any I/O
1837 operation if the <em class="parameter"><code>parse_name</code></em> cannot be parsed.
1839 <div class="variablelist"><table border="0">
1840 <col align="left" valign="top">
1843 <td><p><span class="term"><em class="parameter"><code>parse_name</code></em> :</span></p></td>
1844 <td>a file name or path to be parsed.</td>
1847 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1848 <td>a new <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1855 <div class="refsect2">
1856 <a name="g-file-dup"></a><h3>g_file_dup ()</h3>
1857 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_dup (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
1859 Duplicates a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> handle. This operation does not duplicate
1860 the actual file or directory represented by the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>; see
1861 <a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()"><code class="function">g_file_copy()</code></a> if attempting to copy a file.
1864 This call does no blocking i/o.
1866 <div class="variablelist"><table border="0">
1867 <col align="left" valign="top">
1870 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
1871 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1874 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1875 <td>a new <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> that is a duplicate of the given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1882 <div class="refsect2">
1883 <a name="g-file-hash"></a><h3>g_file_hash ()</h3>
1884 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_file_hash (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> file</code></em>);</pre>
1886 Creates a hash value for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
1889 This call does no blocking i/o.
1894 <div class="variablelist"><table border="0">
1895 <col align="left" valign="top">
1898 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
1900 <a href="./../glib/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> to a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GFile]</span>
1904 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1905 <td>0 if <em class="parameter"><code>file</code></em> is not a valid <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, otherwise an
1906 integer that can be used as hash value for the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
1907 This function is intended for easily hashing a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to
1908 add to a <a href="./../glib/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> or similar data structure.</td>
1914 <div class="refsect2">
1915 <a name="g-file-equal"></a><h3>g_file_equal ()</h3>
1916 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_equal (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file1</code></em>,
1917 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file2</code></em>);</pre>
1919 Checks equality of two given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s. Note that two
1920 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>s that differ can still refer to the same
1921 file on the filesystem due to various forms of filename
1925 This call does no blocking i/o.
1927 <div class="variablelist"><table border="0">
1928 <col align="left" valign="top">
1931 <td><p><span class="term"><em class="parameter"><code>file1</code></em> :</span></p></td>
1932 <td>the first <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1935 <td><p><span class="term"><em class="parameter"><code>file2</code></em> :</span></p></td>
1936 <td>the second <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1939 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1941 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>file1</code></em> and <em class="parameter"><code>file2</code></em> are equal.
1942 <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if either is not a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1948 <div class="refsect2">
1949 <a name="g-file-get-basename"></a><h3>g_file_get_basename ()</h3>
1950 <pre class="programlisting"><span class="returnvalue">char</span> * g_file_get_basename (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
1952 Gets the base name (the last component of the path) for a given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
1955 If called for the top level of a system (such as the filesystem root
1956 or a uri like sftp://host/) it will return a single directory separator
1957 (and on Windows, possibly a drive letter).
1960 The base name is a byte string (*not* UTF-8). It has no defined encoding
1961 or rules other than it may not contain zero bytes. If you want to use
1962 filenames in a user interface you should use the display name that you
1963 can get by requesting the <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-DISPLAY-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME</code></a>
1964 attribute with <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a>.
1967 This call does no blocking i/o.
1969 <div class="variablelist"><table border="0">
1970 <col align="left" valign="top">
1973 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
1974 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
1977 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1978 <td>string containing the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s base name, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1979 if given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> is invalid. The returned string should be
1980 freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.</td>
1986 <div class="refsect2">
1987 <a name="g-file-get-path"></a><h3>g_file_get_path ()</h3>
1988 <pre class="programlisting"><span class="returnvalue">char</span> * g_file_get_path (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
1990 Gets the local pathname for <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, if one exists.
1993 This call does no blocking i/o.
1995 <div class="variablelist"><table border="0">
1996 <col align="left" valign="top">
1999 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2000 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2003 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2004 <td>string containing the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s path, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
2005 no such path exists. The returned string should be
2006 freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.</td>
2012 <div class="refsect2">
2013 <a name="g-file-get-uri"></a><h3>g_file_get_uri ()</h3>
2014 <pre class="programlisting"><span class="returnvalue">char</span> * g_file_get_uri (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
2016 Gets the URI for the <em class="parameter"><code>file</code></em>.
2019 This call does no blocking i/o.
2021 <div class="variablelist"><table border="0">
2022 <col align="left" valign="top">
2025 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2026 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2029 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2030 <td>a string containing the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s URI.
2031 The returned string should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.</td>
2037 <div class="refsect2">
2038 <a name="g-file-get-parse-name"></a><h3>g_file_get_parse_name ()</h3>
2039 <pre class="programlisting"><span class="returnvalue">char</span> * g_file_get_parse_name (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
2041 Gets the parse name of the <em class="parameter"><code>file</code></em>.
2042 A parse name is a UTF-8 string that describes the
2043 file such that one can get the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> back using
2044 <a class="link" href="GFile.html#g-file-parse-name" title="g_file_parse_name ()"><code class="function">g_file_parse_name()</code></a>.
2047 This is generally used to show the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> as a nice
2048 full-pathname kind of string in a user interface,
2049 like in a location entry.
2052 For local files with names that can safely be converted
2053 to UTF8 the pathname is used, otherwise the IRI is used
2054 (a form of URI that allows UTF8 characters unescaped).
2057 This call does no blocking i/o.
2059 <div class="variablelist"><table border="0">
2060 <col align="left" valign="top">
2063 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2064 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2067 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2068 <td>a string containing the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s parse name. The returned
2069 string should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.</td>
2075 <div class="refsect2">
2076 <a name="g-file-get-parent"></a><h3>g_file_get_parent ()</h3>
2077 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_get_parent (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
2079 Gets the parent directory for the <em class="parameter"><code>file</code></em>.
2080 If the <em class="parameter"><code>file</code></em> represents the root directory of the
2081 file system, then <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.
2084 This call does no blocking i/o.
2086 <div class="variablelist"><table border="0">
2087 <col align="left" valign="top">
2090 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2091 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2094 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2095 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> structure to the parent of the given
2096 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no parent.
2097 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2104 <div class="refsect2">
2105 <a name="g-file-has-parent"></a><h3>g_file_has_parent ()</h3>
2106 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_has_parent (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2107 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *parent</code></em>);</pre>
2109 Checks if <em class="parameter"><code>file</code></em> has a parent, and optionally, if it is <em class="parameter"><code>parent</code></em>.
2112 If <em class="parameter"><code>parent</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then this function returns <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>file</code></em> has any
2113 parent at all. If <em class="parameter"><code>parent</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is only returned
2114 if <em class="parameter"><code>file</code></em> is a child of <em class="parameter"><code>parent</code></em>.
2116 <div class="variablelist"><table border="0">
2117 <col align="left" valign="top">
2120 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2121 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
2125 <td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
2126 <td>the parent to check for, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2130 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2132 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>file</code></em> is a child of <em class="parameter"><code>parent</code></em> (or any parent in the
2133 case that <em class="parameter"><code>parent</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</td>
2137 <p class="since">Since 2.24</p>
2140 <div class="refsect2">
2141 <a name="g-file-get-child"></a><h3>g_file_get_child ()</h3>
2142 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_get_child (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2143 <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
2145 Gets a child of <em class="parameter"><code>file</code></em> with basename equal to <em class="parameter"><code>name</code></em>.
2148 Note that the file with that specific name might not exist, but
2149 you can still have a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> that points to it. You can use this
2150 for instance to create that file.
2153 This call does no blocking i/o.
2155 <div class="variablelist"><table border="0">
2156 <col align="left" valign="top">
2159 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2160 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2163 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
2164 <td>string containing the child's basename.</td>
2167 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2168 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to a child specified by <em class="parameter"><code>name</code></em>.
2169 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2176 <div class="refsect2">
2177 <a name="g-file-get-child-for-display-name"></a><h3>g_file_get_child_for_display_name ()</h3>
2178 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_get_child_for_display_name (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2179 <em class="parameter"><code>const <span class="type">char</span> *display_name</code></em>,
2180 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2182 Gets the child of <em class="parameter"><code>file</code></em> for a given <em class="parameter"><code>display_name</code></em> (i.e. a UTF8
2183 version of the name). If this function fails, it returns <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <em class="parameter"><code>error</code></em> will be
2184 set. This is very useful when constructing a GFile for a new file
2185 and the user entered the filename in the user interface, for instance
2186 when you select a directory and type a filename in the file selector.
2189 This call does no blocking i/o.
2191 <div class="variablelist"><table border="0">
2192 <col align="left" valign="top">
2195 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2196 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2199 <td><p><span class="term"><em class="parameter"><code>display_name</code></em> :</span></p></td>
2200 <td>string to a possible child.</td>
2203 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2205 <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
2208 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2209 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to the specified child, or
2210 <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the display name couldn't be converted.
2211 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2218 <div class="refsect2">
2219 <a name="g-file-has-prefix"></a><h3>g_file_has_prefix ()</h3>
2220 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_has_prefix (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2221 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *prefix</code></em>);</pre>
2223 Checks whether <em class="parameter"><code>file</code></em> has the prefix specified by <em class="parameter"><code>prefix</code></em>. In other word,
2224 if the names of initial elements of <em class="parameter"><code>file</code></em>s pathname match <em class="parameter"><code>prefix</code></em>.
2225 Only full pathname elements are matched, so a path like /foo is not
2226 considered a prefix of /foobar, only of /foo/bar.
2229 This call does no i/o, as it works purely on names. As such it can
2230 sometimes return <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> even if <em class="parameter"><code>file</code></em> is inside a <em class="parameter"><code>prefix</code></em> (from a
2231 filesystem point of view), because the prefix of <em class="parameter"><code>file</code></em> is an alias
2232 of <em class="parameter"><code>prefix</code></em>.
2235 Virtual: prefix_matches
2237 <div class="variablelist"><table border="0">
2238 <col align="left" valign="top">
2241 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2242 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2245 <td><p><span class="term"><em class="parameter"><code>prefix</code></em> :</span></p></td>
2246 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2249 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2251 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>files</code></em>'s parent, grandparent, etc is <em class="parameter"><code>prefix</code></em>.
2252 <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2258 <div class="refsect2">
2259 <a name="g-file-get-relative-path"></a><h3>g_file_get_relative_path ()</h3>
2260 <pre class="programlisting"><span class="returnvalue">char</span> * g_file_get_relative_path (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *parent</code></em>,
2261 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *descendant</code></em>);</pre>
2263 Gets the path for <em class="parameter"><code>descendant</code></em> relative to <em class="parameter"><code>parent</code></em>.
2266 This call does no blocking i/o.
2268 <div class="variablelist"><table border="0">
2269 <col align="left" valign="top">
2272 <td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
2273 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2276 <td><p><span class="term"><em class="parameter"><code>descendant</code></em> :</span></p></td>
2277 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2280 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2281 <td>string with the relative path from <em class="parameter"><code>descendant</code></em>
2282 to <em class="parameter"><code>parent</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>descendant</code></em> doesn't have <em class="parameter"><code>parent</code></em> as prefix.
2283 The returned string should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.</td>
2289 <div class="refsect2">
2290 <a name="g-file-resolve-relative-path"></a><h3>g_file_resolve_relative_path ()</h3>
2291 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_resolve_relative_path (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2292 <em class="parameter"><code>const <span class="type">char</span> *relative_path</code></em>);</pre>
2294 Resolves a relative path for <em class="parameter"><code>file</code></em> to an absolute path.
2297 This call does no blocking i/o.
2299 <div class="variablelist"><table border="0">
2300 <col align="left" valign="top">
2303 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2304 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2307 <td><p><span class="term"><em class="parameter"><code>relative_path</code></em> :</span></p></td>
2308 <td>a given relative path string.</td>
2311 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2313 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to the resolved path. <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>relative_path</code></em>
2314 is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or if <em class="parameter"><code>file</code></em> is invalid.
2315 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2322 <div class="refsect2">
2323 <a name="g-file-is-native"></a><h3>g_file_is_native ()</h3>
2324 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_is_native (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
2326 Checks to see if a file is native to the platform.
2329 A native file s one expressed in the platform-native filename format,
2330 e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
2331 as it might be on a locally mounted remote filesystem.
2334 On some systems non-native files may be available using
2335 the native filesystem via a userspace filesystem (FUSE), in
2336 these cases this call will return <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, but <a class="link" href="GFile.html#g-file-get-path" title="g_file_get_path ()"><code class="function">g_file_get_path()</code></a>
2337 will still return a native path.
2340 This call does no blocking i/o.
2342 <div class="variablelist"><table border="0">
2343 <col align="left" valign="top">
2346 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2347 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2350 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2352 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if file is native.</td>
2358 <div class="refsect2">
2359 <a name="g-file-has-uri-scheme"></a><h3>g_file_has_uri_scheme ()</h3>
2360 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_has_uri_scheme (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2361 <em class="parameter"><code>const <span class="type">char</span> *uri_scheme</code></em>);</pre>
2363 Checks to see if a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> has a given URI scheme.
2366 This call does no blocking i/o.
2368 <div class="variablelist"><table border="0">
2369 <col align="left" valign="top">
2372 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2373 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2376 <td><p><span class="term"><em class="parameter"><code>uri_scheme</code></em> :</span></p></td>
2377 <td>a string containing a URI scheme.</td>
2380 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2382 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>'s backend supports the
2383 given URI scheme, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if URI scheme is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
2384 not supported, or <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> is invalid.</td>
2390 <div class="refsect2">
2391 <a name="g-file-get-uri-scheme"></a><h3>g_file_get_uri_scheme ()</h3>
2392 <pre class="programlisting"><span class="returnvalue">char</span> * g_file_get_uri_scheme (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
2394 Gets the URI scheme for a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
2395 RFC 3986 decodes the scheme as:
2397 <pre class="programlisting">
2398 URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
2401 Common schemes include "file", "http", "ftp", etc.
2404 This call does no blocking i/o.
2406 <div class="variablelist"><table border="0">
2407 <col align="left" valign="top">
2410 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2411 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2414 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2415 <td>a string containing the URI scheme for the given
2416 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>. The returned string should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
2417 when no longer needed.</td>
2423 <div class="refsect2">
2424 <a name="g-file-read"></a><h3>g_file_read ()</h3>
2425 <pre class="programlisting"><a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="returnvalue">GFileInputStream</span></a> * g_file_read (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2426 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2427 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2429 Opens a file for reading. The result is a <a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="type">GFileInputStream</span></a> that
2430 can be used to read the contents of the file.
2433 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
2434 triggering the cancellable object from another thread. If the operation
2435 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
2438 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
2439 If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
2440 Other errors are possible too, and depend on what kind of filesystem the file is on.
2445 <div class="variablelist"><table border="0">
2446 <col align="left" valign="top">
2449 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2451 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to read.</td>
2454 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2455 <td>a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2459 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2460 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2464 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2466 <a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="type">GFileInputStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2467 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2474 <div class="refsect2">
2475 <a name="g-file-read-async"></a><h3>g_file_read_async ()</h3>
2476 <pre class="programlisting"><span class="returnvalue">void</span> g_file_read_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2477 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
2478 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2479 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2480 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2482 Asynchronously opens <em class="parameter"><code>file</code></em> for reading.
2485 For more details, see <a class="link" href="GFile.html#g-file-read" title="g_file_read ()"><code class="function">g_file_read()</code></a> which is
2486 the synchronous version of this call.
2489 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2490 <a class="link" href="GFile.html#g-file-read-finish" title="g_file_read_finish ()"><code class="function">g_file_read_finish()</code></a> to get the result of the operation.
2492 <div class="variablelist"><table border="0">
2493 <col align="left" valign="top">
2496 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2497 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
2501 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
2502 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
2503 of the request.</td>
2506 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2507 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2511 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2512 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
2516 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2517 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
2524 <div class="refsect2">
2525 <a name="g-file-read-finish"></a><h3>g_file_read_finish ()</h3>
2526 <pre class="programlisting"><a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="returnvalue">GFileInputStream</span></a> * g_file_read_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2527 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
2528 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2530 Finishes an asynchronous file read operation started with
2531 <a class="link" href="GFile.html#g-file-read-async" title="g_file_read_async ()"><code class="function">g_file_read_async()</code></a>.
2533 <div class="variablelist"><table border="0">
2534 <col align="left" valign="top">
2537 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2538 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2541 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
2542 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
2545 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2546 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2550 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2551 <td>a <a class="link" href="GFileInputStream.html" title="GFileInputStream"><span class="type">GFileInputStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2552 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2559 <div class="refsect2">
2560 <a name="g-file-append-to"></a><h3>g_file_append_to ()</h3>
2561 <pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * g_file_append_to (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2562 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
2563 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2564 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2566 Gets an output stream for appending data to the file. If
2567 the file doesn't already exist it is created.
2570 By default files created are generally readable by everyone,
2571 but if you pass <a class="link" href="GFile.html#G-FILE-CREATE-PRIVATE:CAPS"><span class="type">G_FILE_CREATE_PRIVATE</span></a> in <em class="parameter"><code>flags</code></em> the file
2572 will be made readable only to the current user, to the level that
2573 is supported on the target filesystem.
2576 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
2577 triggering the cancellable object from another thread. If the operation
2578 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
2581 Some file systems don't allow all file names, and may
2582 return an <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-FILENAME:CAPS"><code class="literal">G_IO_ERROR_INVALID_FILENAME</code></a> error.
2583 If the file is a directory the <a class="link" href="gio-GIOError.html#G-IO-ERROR-IS-DIRECTORY:CAPS"><code class="literal">G_IO_ERROR_IS_DIRECTORY</code></a> error will be
2584 returned. Other errors are possible too, and depend on what kind of
2585 filesystem the file is on.
2587 <div class="variablelist"><table border="0">
2588 <col align="left" valign="top">
2591 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2592 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2595 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
2596 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
2599 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2600 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2604 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2605 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2609 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2610 <td>a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2611 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2618 <div class="refsect2">
2619 <a name="g-file-create"></a><h3>g_file_create ()</h3>
2620 <pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * g_file_create (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2621 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
2622 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2623 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2625 Creates a new file and returns an output stream for writing to it.
2626 The file must not already exist.
2629 By default files created are generally readable by everyone,
2630 but if you pass <a class="link" href="GFile.html#G-FILE-CREATE-PRIVATE:CAPS"><span class="type">G_FILE_CREATE_PRIVATE</span></a> in <em class="parameter"><code>flags</code></em> the file
2631 will be made readable only to the current user, to the level that
2632 is supported on the target filesystem.
2635 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
2636 triggering the cancellable object from another thread. If the operation
2637 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
2640 If a file or directory with this name already exists the G_IO_ERROR_EXISTS
2641 error will be returned.
2642 Some file systems don't allow all file names, and may
2643 return an G_IO_ERROR_INVALID_FILENAME error, and if the name
2644 is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
2645 Other errors are possible too, and depend on what kind of
2646 filesystem the file is on.
2648 <div class="variablelist"><table border="0">
2649 <col align="left" valign="top">
2652 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2653 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2656 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
2657 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
2660 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2661 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2665 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2666 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2670 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2671 <td>a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a> for the newly created file, or
2672 <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2673 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2680 <div class="refsect2">
2681 <a name="g-file-replace"></a><h3>g_file_replace ()</h3>
2682 <pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * g_file_replace (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2683 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
2684 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
2685 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
2686 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2687 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2689 Returns an output stream for overwriting the file, possibly
2690 creating a backup copy of the file first. If the file doesn't exist,
2694 This will try to replace the file in the safest way possible so
2695 that any errors during the writing will not affect an already
2696 existing copy of the file. For instance, for local files it
2697 may write to a temporary file and then atomically rename over
2698 the destination when the stream is closed.
2701 By default files created are generally readable by everyone,
2702 but if you pass <a class="link" href="GFile.html#G-FILE-CREATE-PRIVATE:CAPS"><span class="type">G_FILE_CREATE_PRIVATE</span></a> in <em class="parameter"><code>flags</code></em> the file
2703 will be made readable only to the current user, to the level that
2704 is supported on the target filesystem.
2707 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
2708 triggering the cancellable object from another thread. If the operation
2709 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
2712 If you pass in a non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> <em class="parameter"><code>etag</code></em> value, then this value is
2713 compared to the current entity tag of the file, and if they differ
2714 an G_IO_ERROR_WRONG_ETAG error is returned. This generally means
2715 that the file has been changed since you last read it. You can get
2716 the new etag from <a class="link" href="GFileOutputStream.html#g-file-output-stream-get-etag" title="g_file_output_stream_get_etag ()"><code class="function">g_file_output_stream_get_etag()</code></a> after you've
2717 finished writing and closed the <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a>. When you load
2718 a new file you can use <a class="link" href="GFileInputStream.html#g-file-input-stream-query-info" title="g_file_input_stream_query_info ()"><code class="function">g_file_input_stream_query_info()</code></a> to get
2719 the etag of the file.
2722 If <em class="parameter"><code>make_backup</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to make a backup
2723 of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP
2724 error will be returned. If you want to replace anyway, try again with
2725 <em class="parameter"><code>make_backup</code></em> set to <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
2728 If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned,
2729 and if the file is some other form of non-regular file then a
2730 G_IO_ERROR_NOT_REGULAR_FILE error will be returned.
2731 Some file systems don't allow all file names, and may
2732 return an G_IO_ERROR_INVALID_FILENAME error, and if the name
2733 is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
2734 Other errors are possible too, and depend on what kind of
2735 filesystem the file is on.
2737 <div class="variablelist"><table border="0">
2738 <col align="left" valign="top">
2741 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2742 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2745 <td><p><span class="term"><em class="parameter"><code>etag</code></em> :</span></p></td>
2746 <td>an optional <a class="link" href="GFile.html#gfile-etag">entity tag</a> for the
2747 current <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2751 <td><p><span class="term"><em class="parameter"><code>make_backup</code></em> :</span></p></td>
2753 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created.</td>
2756 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
2757 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
2760 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2761 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2765 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2766 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2770 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2771 <td>a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2772 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2779 <div class="refsect2">
2780 <a name="g-file-append-to-async"></a><h3>g_file_append_to_async ()</h3>
2781 <pre class="programlisting"><span class="returnvalue">void</span> g_file_append_to_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2782 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
2783 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
2784 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2785 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2786 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2788 Asynchronously opens <em class="parameter"><code>file</code></em> for appending.
2791 For more details, see <a class="link" href="GFile.html#g-file-append-to" title="g_file_append_to ()"><code class="function">g_file_append_to()</code></a> which is
2792 the synchronous version of this call.
2795 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2796 <a class="link" href="GFile.html#g-file-append-to-finish" title="g_file_append_to_finish ()"><code class="function">g_file_append_to_finish()</code></a> to get the result of the operation.
2798 <div class="variablelist"><table border="0">
2799 <col align="left" valign="top">
2802 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2803 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2806 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
2807 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
2810 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
2811 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
2812 of the request.</td>
2815 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2816 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2820 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2821 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
2825 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2826 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
2833 <div class="refsect2">
2834 <a name="g-file-append-to-finish"></a><h3>g_file_append_to_finish ()</h3>
2835 <pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * g_file_append_to_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2836 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
2837 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2839 Finishes an asynchronous file append operation started with
2840 <a class="link" href="GFile.html#g-file-append-to-async" title="g_file_append_to_async ()"><code class="function">g_file_append_to_async()</code></a>.
2842 <div class="variablelist"><table border="0">
2843 <col align="left" valign="top">
2846 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2847 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2850 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
2851 <td><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a></td>
2854 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2855 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2859 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2860 <td>a valid <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2861 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2868 <div class="refsect2">
2869 <a name="g-file-create-async"></a><h3>g_file_create_async ()</h3>
2870 <pre class="programlisting"><span class="returnvalue">void</span> g_file_create_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2871 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
2872 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
2873 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2874 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2875 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2877 Asynchronously creates a new file and returns an output stream for writing to it.
2878 The file must not already exist.
2881 For more details, see <a class="link" href="GFile.html#g-file-create" title="g_file_create ()"><code class="function">g_file_create()</code></a> which is
2882 the synchronous version of this call.
2885 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2886 <a class="link" href="GFile.html#g-file-create-finish" title="g_file_create_finish ()"><code class="function">g_file_create_finish()</code></a> to get the result of the operation.
2888 <div class="variablelist"><table border="0">
2889 <col align="left" valign="top">
2892 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2893 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2896 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
2897 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
2900 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
2901 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
2902 of the request.</td>
2905 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
2906 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2910 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2911 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
2915 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2916 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
2923 <div class="refsect2">
2924 <a name="g-file-create-finish"></a><h3>g_file_create_finish ()</h3>
2925 <pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * g_file_create_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2926 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
2927 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2929 Finishes an asynchronous file create operation started with
2930 <a class="link" href="GFile.html#g-file-create-async" title="g_file_create_async ()"><code class="function">g_file_create_async()</code></a>.
2932 <div class="variablelist"><table border="0">
2933 <col align="left" valign="top">
2936 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2937 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2940 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
2941 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
2944 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2945 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2949 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2950 <td>a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
2951 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2958 <div class="refsect2">
2959 <a name="g-file-replace-async"></a><h3>g_file_replace_async ()</h3>
2960 <pre class="programlisting"><span class="returnvalue">void</span> g_file_replace_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
2961 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
2962 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
2963 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
2964 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
2965 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
2966 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2967 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2969 Asynchronously overwrites the file, replacing the contents, possibly
2970 creating a backup copy of the file first.
2973 For more details, see <a class="link" href="GFile.html#g-file-replace" title="g_file_replace ()"><code class="function">g_file_replace()</code></a> which is
2974 the synchronous version of this call.
2977 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2978 <a class="link" href="GFile.html#g-file-replace-finish" title="g_file_replace_finish ()"><code class="function">g_file_replace_finish()</code></a> to get the result of the operation.
2980 <div class="variablelist"><table border="0">
2981 <col align="left" valign="top">
2984 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2985 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
2988 <td><p><span class="term"><em class="parameter"><code>etag</code></em> :</span></p></td>
2989 <td>an <a class="link" href="GFile.html#gfile-etag">entity tag</a> for the
2990 current <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, or NULL to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2994 <td><p><span class="term"><em class="parameter"><code>make_backup</code></em> :</span></p></td>
2996 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created.</td>
2999 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
3000 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
3003 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
3004 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
3005 of the request.</td>
3008 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3009 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3013 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3014 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
3018 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3019 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
3026 <div class="refsect2">
3027 <a name="g-file-replace-finish"></a><h3>g_file_replace_finish ()</h3>
3028 <pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="returnvalue">GFileOutputStream</span></a> * g_file_replace_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3029 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
3030 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3032 Finishes an asynchronous file replace operation started with
3033 <a class="link" href="GFile.html#g-file-replace-async" title="g_file_replace_async ()"><code class="function">g_file_replace_async()</code></a>.
3035 <div class="variablelist"><table border="0">
3036 <col align="left" valign="top">
3039 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3040 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3043 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
3044 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
3047 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3048 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3052 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3053 <td>a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3054 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3061 <div class="refsect2">
3062 <a name="g-file-query-info"></a><h3>g_file_query_info ()</h3>
3063 <pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * g_file_query_info (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3064 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
3065 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
3066 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3067 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3069 Gets the requested information about specified <em class="parameter"><code>file</code></em>. The result
3070 is a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> object that contains key-value attributes (such as
3071 the type or size of the file).
3074 The <em class="parameter"><code>attributes</code></em> value is a string that specifies the file attributes that
3075 should be gathered. It is not an error if it's not possible to read a particular
3076 requested attribute from a file - it just won't be set. <em class="parameter"><code>attributes</code></em> should
3077 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
3078 means all attributes, and a wildcard like "standard::*" means all attributes in the standard
3079 namespace. An example attribute query be "standard::*,owner::user".
3080 The standard attributes are available as defines, like <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_NAME"><span class="type">G_FILE_ATTRIBUTE_STANDARD_NAME</span></a>.
3083 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3084 triggering the cancellable object from another thread. If the operation
3085 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3088 For symlinks, normally the information about the target of the
3089 symlink is returned, rather than information about the symlink itself.
3090 However if you pass <a class="link" href="GFile.html#G-FILE-QUERY-INFO-NOFOLLOW-SYMLINKS:CAPS"><span class="type">G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS</span></a> in <em class="parameter"><code>flags</code></em> the
3091 information about the symlink itself will be returned. Also, for symlinks
3092 that point to non-existing files the information about the symlink itself
3096 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
3097 Other errors are possible too, and depend on what kind of filesystem the file is on.
3099 <div class="variablelist"><table border="0">
3100 <col align="left" valign="top">
3103 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3104 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3107 <td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td>
3108 <td>an attribute query string.</td>
3111 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
3112 <td>a set of <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
3115 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3116 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3120 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3121 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
3124 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3125 <td>a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for the given <em class="parameter"><code>file</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3126 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3133 <div class="refsect2">
3134 <a name="g-file-query-info-async"></a><h3>g_file_query_info_async ()</h3>
3135 <pre class="programlisting"><span class="returnvalue">void</span> g_file_query_info_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3136 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
3137 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
3138 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
3139 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3140 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3141 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3143 Asynchronously gets the requested information about specified <em class="parameter"><code>file</code></em>. The result
3144 is a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> object that contains key-value attributes (such as type or size
3148 For more details, see <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a> which is
3149 the synchronous version of this call.
3152 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
3153 <a class="link" href="GFile.html#g-file-query-info-finish" title="g_file_query_info_finish ()"><code class="function">g_file_query_info_finish()</code></a> to get the result of the operation.
3155 <div class="variablelist"><table border="0">
3156 <col align="left" valign="top">
3159 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3160 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3163 <td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td>
3164 <td>an attribute query string.</td>
3167 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
3168 <td>a set of <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
3171 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
3172 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
3173 of the request.</td>
3176 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3177 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3181 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3182 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
3186 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3187 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
3194 <div class="refsect2">
3195 <a name="g-file-query-info-finish"></a><h3>g_file_query_info_finish ()</h3>
3196 <pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * g_file_query_info_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3197 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
3198 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3200 Finishes an asynchronous file info query.
3201 See <a class="link" href="GFile.html#g-file-query-info-async" title="g_file_query_info_async ()"><code class="function">g_file_query_info_async()</code></a>.
3203 <div class="variablelist"><table border="0">
3204 <col align="left" valign="top">
3207 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3208 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3211 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
3212 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
3215 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3216 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
3219 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3221 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for given <em class="parameter"><code>file</code></em> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3222 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3229 <div class="refsect2">
3230 <a name="g-file-query-exists"></a><h3>g_file_query_exists ()</h3>
3231 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_query_exists (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3232 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre>
3234 Utility function to check if a particular file exists. This is
3235 implemented using <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a> and as such does blocking I/O.
3238 Note that in many cases it is racy to first check for file existence
3239 and then execute something based on the outcome of that, because the
3240 file might have been created or removed in between the operations. The
3241 general approach to handling that is to not check, but just do the
3242 operation and handle the errors as they come.
3245 As an example of race-free checking, take the case of reading a file, and
3246 if it doesn't exist, creating it. There are two racy versions: read it, and
3247 on error create it; and: check if it exists, if not create it. These
3248 can both result in two processes creating the file (with perhaps a partially
3249 written file as the result). The correct approach is to always try to create
3250 the file with <a class="link" href="GFile.html#g-file-create" title="g_file_create ()"><code class="function">g_file_create()</code></a> which will either atomically create the file
3251 or fail with a G_IO_ERROR_EXISTS error.
3254 However, in many cases an existence check is useful in a user
3255 interface, for instance to make a menu item sensitive/insensitive, so that
3256 you don't have to fool users that something is possible and then just show
3257 and error dialog. If you do this, you should make sure to also handle the
3258 errors that can happen due to races when you execute the operation.
3260 <div class="variablelist"><table border="0">
3261 <col align="left" valign="top">
3264 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3265 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3268 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3269 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3273 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3275 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file exists (and can be detected without error), <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise (or if cancelled).</td>
3281 <div class="refsect2">
3282 <a name="g-file-query-file-type"></a><h3>g_file_query_file_type ()</h3>
3283 <pre class="programlisting"><a class="link" href="GFileInfo.html#GFileType" title="enum GFileType"><span class="returnvalue">GFileType</span></a> g_file_query_file_type (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3284 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
3285 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre>
3287 Utility function to inspect the <a class="link" href="GFileInfo.html#GFileType" title="enum GFileType"><span class="type">GFileType</span></a> of a file. This is
3288 implemented using <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a> and as such does blocking I/O.
3291 The primary use case of this method is to check if a file is a regular file,
3292 directory, or symlink.
3294 <div class="variablelist"><table border="0">
3295 <col align="left" valign="top">
3298 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3299 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3302 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
3303 <td>a set of <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> passed to <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a>.</td>
3306 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3307 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3311 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3312 <td>The <a class="link" href="GFileInfo.html#GFileType" title="enum GFileType"><span class="type">GFileType</span></a> of the file and <a class="link" href="GFileInfo.html#G-FILE-TYPE-UNKNOWN:CAPS"><span class="type">G_FILE_TYPE_UNKNOWN</span></a> if the file
3317 <p class="since">Since 2.18</p>
3320 <div class="refsect2">
3321 <a name="g-file-query-filesystem-info"></a><h3>g_file_query_filesystem_info ()</h3>
3322 <pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * g_file_query_filesystem_info (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3323 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
3324 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3325 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3327 Similar to <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a>, but obtains information
3328 about the filesystem the <em class="parameter"><code>file</code></em> is on, rather than the file itself.
3329 For instance the amount of space available and the type of
3333 The <em class="parameter"><code>attributes</code></em> value is a string that specifies the file attributes that
3334 should be gathered. It is not an error if it's not possible to read a particular
3335 requested attribute from a file - it just won't be set. <em class="parameter"><code>attributes</code></em> should
3336 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
3337 means all attributes, and a wildcard like "filesystem::*" means all attributes in the
3338 filesystem namespace. The standard namespace for filesystem attributes is "filesystem".
3339 Common attributes of interest are <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-SIZE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_SIZE"><span class="type">G_FILE_ATTRIBUTE_FILESYSTEM_SIZE</span></a>
3340 (the total size of the filesystem in bytes), <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-FREE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_FREE"><span class="type">G_FILE_ATTRIBUTE_FILESYSTEM_FREE</span></a> (number of
3341 bytes available), and <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-TYPE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_TYPE"><span class="type">G_FILE_ATTRIBUTE_FILESYSTEM_TYPE</span></a> (type of the filesystem).
3344 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3345 triggering the cancellable object from another thread. If the operation
3346 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3349 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
3350 Other errors are possible too, and depend on what kind of filesystem the file is on.
3352 <div class="variablelist"><table border="0">
3353 <col align="left" valign="top">
3356 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3357 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3360 <td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td>
3361 <td>an attribute query string.</td>
3364 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3365 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3369 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3370 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
3373 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3374 <td>a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there was an error.
3375 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3382 <div class="refsect2">
3383 <a name="g-file-query-filesystem-info-async"></a><h3>g_file_query_filesystem_info_async ()</h3>
3384 <pre class="programlisting"><span class="returnvalue">void</span> g_file_query_filesystem_info_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3385 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
3386 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
3387 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3388 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3389 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3391 Asynchronously gets the requested information about the filesystem
3392 that the specified <em class="parameter"><code>file</code></em> is on. The result is a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> object
3393 that contains key-value attributes (such as type or size for the
3397 For more details, see <a class="link" href="GFile.html#g-file-query-filesystem-info" title="g_file_query_filesystem_info ()"><code class="function">g_file_query_filesystem_info()</code></a> which is the
3398 synchronous version of this call.
3401 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can
3402 then call <a class="link" href="GFile.html#g-file-query-info-finish" title="g_file_query_info_finish ()"><code class="function">g_file_query_info_finish()</code></a> to get the result of the
3405 <div class="variablelist"><table border="0">
3406 <col align="left" valign="top">
3409 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3410 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3413 <td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td>
3414 <td>an attribute query string.</td>
3417 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
3418 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
3419 of the request.</td>
3422 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3423 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3427 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3428 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
3432 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3433 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
3440 <div class="refsect2">
3441 <a name="g-file-query-filesystem-info-finish"></a><h3>g_file_query_filesystem_info_finish ()</h3>
3442 <pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * g_file_query_filesystem_info_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3443 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
3444 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3446 Finishes an asynchronous filesystem info query. See
3447 <a class="link" href="GFile.html#g-file-query-filesystem-info-async" title="g_file_query_filesystem_info_async ()"><code class="function">g_file_query_filesystem_info_async()</code></a>.
3449 <div class="variablelist"><table border="0">
3450 <col align="left" valign="top">
3453 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3454 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3457 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
3458 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
3461 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3462 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
3465 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3467 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> for given <em class="parameter"><code>file</code></em> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3468 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3475 <div class="refsect2">
3476 <a name="g-file-query-default-handler"></a><h3>g_file_query_default_handler ()</h3>
3477 <pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo"><span class="returnvalue">GAppInfo</span></a> * g_file_query_default_handler (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3478 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3479 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3481 Returns the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> that is registered as the default
3482 application to handle the file specified by <em class="parameter"><code>file</code></em>.
3485 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3486 triggering the cancellable object from another thread. If the operation
3487 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3489 <div class="variablelist"><table border="0">
3490 <col align="left" valign="top">
3493 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3494 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to open.</td>
3497 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3498 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
3501 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3502 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3506 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3507 <td>a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> if the handle was found, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there were errors.
3508 When you are done with it, release it with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3515 <div class="refsect2">
3516 <a name="g-file-find-enclosing-mount"></a><h3>g_file_find_enclosing_mount ()</h3>
3517 <pre class="programlisting"><a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> * g_file_find_enclosing_mount (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3518 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3519 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3521 Gets a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> for the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
3524 If the <a class="link" href="GFile.html#GFileIface" title="struct GFileIface"><span class="type">GFileIface</span></a> for <em class="parameter"><code>file</code></em> does not have a mount (e.g. possibly a
3525 remote share), <em class="parameter"><code>error</code></em> will be set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-FOUND:CAPS"><code class="literal">G_IO_ERROR_NOT_FOUND</code></a> and <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3529 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3530 triggering the cancellable object from another thread. If the operation
3531 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3533 <div class="variablelist"><table border="0">
3534 <col align="left" valign="top">
3537 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3538 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3541 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3542 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3546 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3547 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
3550 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3551 <td>a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> where the <em class="parameter"><code>file</code></em> is located or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3552 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3559 <div class="refsect2">
3560 <a name="g-file-find-enclosing-mount-async"></a><h3>g_file_find_enclosing_mount_async ()</h3>
3561 <pre class="programlisting"><span class="returnvalue">void</span> g_file_find_enclosing_mount_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3562 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
3563 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3564 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3565 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3567 Asynchronously gets the mount for the file.
3570 For more details, see <a class="link" href="GFile.html#g-file-find-enclosing-mount" title="g_file_find_enclosing_mount ()"><code class="function">g_file_find_enclosing_mount()</code></a> which is
3571 the synchronous version of this call.
3574 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
3575 <a class="link" href="GFile.html#g-file-find-enclosing-mount-finish" title="g_file_find_enclosing_mount_finish ()"><code class="function">g_file_find_enclosing_mount_finish()</code></a> to get the result of the operation.
3577 <div class="variablelist"><table border="0">
3578 <col align="left" valign="top">
3581 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3582 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
3586 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
3587 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
3588 of the request.</td>
3591 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3592 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3596 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3597 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
3601 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3602 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
3609 <div class="refsect2">
3610 <a name="g-file-find-enclosing-mount-finish"></a><h3>g_file_find_enclosing_mount_finish ()</h3>
3611 <pre class="programlisting"><a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> * g_file_find_enclosing_mount_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3612 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
3613 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3615 Finishes an asynchronous find mount request.
3616 See <a class="link" href="GFile.html#g-file-find-enclosing-mount-async" title="g_file_find_enclosing_mount_async ()"><code class="function">g_file_find_enclosing_mount_async()</code></a>.
3618 <div class="variablelist"><table border="0">
3619 <col align="left" valign="top">
3622 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3623 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
3627 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
3628 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>
3632 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3633 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
3637 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3639 <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> for given <em class="parameter"><code>file</code></em> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3640 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3647 <div class="refsect2">
3648 <a name="g-file-enumerate-children"></a><h3>g_file_enumerate_children ()</h3>
3649 <pre class="programlisting"><a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> * g_file_enumerate_children (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3650 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
3651 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
3652 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3653 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3655 Gets the requested information about the files in a directory. The result
3656 is a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a> object that will give out <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> objects for
3657 all the files in the directory.
3660 The <em class="parameter"><code>attributes</code></em> value is a string that specifies the file attributes that
3661 should be gathered. It is not an error if it's not possible to read a particular
3662 requested attribute from a file - it just won't be set. <em class="parameter"><code>attributes</code></em> should
3663 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
3664 means all attributes, and a wildcard like "standard::*" means all attributes in the standard
3665 namespace. An example attribute query be "standard::*,owner::user".
3666 The standard attributes are available as defines, like <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_NAME"><span class="type">G_FILE_ATTRIBUTE_STANDARD_NAME</span></a>.
3669 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3670 triggering the cancellable object from another thread. If the operation
3671 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3674 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
3675 If the file is not a directory, the G_FILE_ERROR_NOTDIR error will be returned.
3676 Other errors are possible too.
3678 <div class="variablelist"><table border="0">
3679 <col align="left" valign="top">
3682 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3683 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3686 <td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td>
3687 <td>an attribute query string.</td>
3690 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
3691 <td>a set of <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
3694 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3695 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3699 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3701 <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting.</td>
3704 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3705 <td>A <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a> if successful, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3706 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3713 <div class="refsect2">
3714 <a name="g-file-enumerate-children-async"></a><h3>g_file_enumerate_children_async ()</h3>
3715 <pre class="programlisting"><span class="returnvalue">void</span> g_file_enumerate_children_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3716 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>,
3717 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
3718 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
3719 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3720 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3721 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3723 Asynchronously gets the requested information about the files in a directory. The result
3724 is a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a> object that will give out <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> objects for
3725 all the files in the directory.
3728 For more details, see <a class="link" href="GFile.html#g-file-enumerate-children" title="g_file_enumerate_children ()"><code class="function">g_file_enumerate_children()</code></a> which is
3729 the synchronous version of this call.
3732 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
3733 <a class="link" href="GFile.html#g-file-enumerate-children-finish" title="g_file_enumerate_children_finish ()"><code class="function">g_file_enumerate_children_finish()</code></a> to get the result of the operation.
3735 <div class="variablelist"><table border="0">
3736 <col align="left" valign="top">
3739 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3740 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3743 <td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td>
3744 <td>an attribute query string.</td>
3747 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
3748 <td>a set of <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
3751 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
3752 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
3753 of the request.</td>
3756 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3757 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3761 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3762 <td>(scope async) : a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the
3763 request is satisfied</td>
3766 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3767 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
3774 <div class="refsect2">
3775 <a name="g-file-enumerate-children-finish"></a><h3>g_file_enumerate_children_finish ()</h3>
3776 <pre class="programlisting"><a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> * g_file_enumerate_children_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3777 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
3778 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3780 Finishes an async enumerate children operation.
3781 See <a class="link" href="GFile.html#g-file-enumerate-children-async" title="g_file_enumerate_children_async ()"><code class="function">g_file_enumerate_children_async()</code></a>.
3783 <div class="variablelist"><table border="0">
3784 <col align="left" valign="top">
3787 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3788 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3791 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
3792 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
3795 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3796 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
3799 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3800 <td>a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred.
3801 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3808 <div class="refsect2">
3809 <a name="g-file-set-display-name"></a><h3>g_file_set_display_name ()</h3>
3810 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_set_display_name (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3811 <em class="parameter"><code>const <span class="type">char</span> *display_name</code></em>,
3812 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3813 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3815 Renames <em class="parameter"><code>file</code></em> to the specified display name.
3818 The display name is converted from UTF8 to the correct encoding for the target
3819 filesystem if possible and the <em class="parameter"><code>file</code></em> is renamed to this.
3822 If you want to implement a rename operation in the user interface the edit name
3823 (<a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-EDIT-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME"><span class="type">G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME</span></a>) should be used as the initial value in the rename
3824 widget, and then the result after editing should be passed to <a class="link" href="GFile.html#g-file-set-display-name" title="g_file_set_display_name ()"><code class="function">g_file_set_display_name()</code></a>.
3827 On success the resulting converted filename is returned.
3830 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3831 triggering the cancellable object from another thread. If the operation
3832 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3834 <div class="variablelist"><table border="0">
3835 <col align="left" valign="top">
3838 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3839 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3842 <td><p><span class="term"><em class="parameter"><code>display_name</code></em> :</span></p></td>
3846 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3847 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3851 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3852 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3856 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3857 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> specifying what <em class="parameter"><code>file</code></em> was renamed to, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3858 if there was an error.
3859 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3866 <div class="refsect2">
3867 <a name="g-file-set-display-name-async"></a><h3>g_file_set_display_name_async ()</h3>
3868 <pre class="programlisting"><span class="returnvalue">void</span> g_file_set_display_name_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3869 <em class="parameter"><code>const <span class="type">char</span> *display_name</code></em>,
3870 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
3871 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3872 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3873 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3875 Asynchronously sets the display name for a given <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
3878 For more details, see <a class="link" href="GFile.html#g-file-set-display-name" title="g_file_set_display_name ()"><code class="function">g_file_set_display_name()</code></a> which is
3879 the synchronous version of this call.
3882 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
3883 <a class="link" href="GFile.html#g-file-set-display-name-finish" title="g_file_set_display_name_finish ()"><code class="function">g_file_set_display_name_finish()</code></a> to get the result of the operation.
3885 <div class="variablelist"><table border="0">
3886 <col align="left" valign="top">
3889 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3890 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3893 <td><p><span class="term"><em class="parameter"><code>display_name</code></em> :</span></p></td>
3897 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
3898 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
3899 of the request.</td>
3902 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3903 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3907 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3908 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
3912 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3913 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
3920 <div class="refsect2">
3921 <a name="g-file-set-display-name-finish"></a><h3>g_file_set_display_name_finish ()</h3>
3922 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_set_display_name_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3923 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
3924 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3926 Finishes setting a display name started with
3927 <a class="link" href="GFile.html#g-file-set-display-name-async" title="g_file_set_display_name_async ()"><code class="function">g_file_set_display_name_async()</code></a>.
3929 <div class="variablelist"><table border="0">
3930 <col align="left" valign="top">
3933 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3934 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3937 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
3938 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
3941 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3942 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3946 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3947 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
3948 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3955 <div class="refsect2">
3956 <a name="g-file-delete"></a><h3>g_file_delete ()</h3>
3957 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_delete (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
3958 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
3959 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3961 Deletes a file. If the <em class="parameter"><code>file</code></em> is a directory, it will only be deleted if it
3965 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
3966 triggering the cancellable object from another thread. If the operation
3967 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
3970 Virtual: delete_file
3972 <div class="variablelist"><table border="0">
3973 <col align="left" valign="top">
3976 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3977 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
3980 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
3981 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
3985 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3986 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3990 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3992 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was deleted. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
3998 <div class="refsect2">
3999 <a name="g-file-trash"></a><h3>g_file_trash ()</h3>
4000 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_trash (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4001 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4002 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4004 Sends <em class="parameter"><code>file</code></em> to the "Trashcan", if possible. This is similar to
4005 deleting it, but the user can recover it before emptying the trashcan.
4006 Not all file systems support trashing, so this call can return the
4007 <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a> error.
4010 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4011 triggering the cancellable object from another thread. If the operation
4012 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4014 <div class="variablelist"><table border="0">
4015 <col align="left" valign="top">
4018 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4020 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to send to trash.</td>
4023 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4024 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4028 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4029 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4033 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4035 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful trash, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4041 <div class="refsect2">
4042 <a name="g-file-copy"></a><h3>g_file_copy ()</h3>
4043 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_copy (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
4044 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
4045 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
4046 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4047 <em class="parameter"><code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> progress_callback</code></em>,
4048 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_callback_data</code></em>,
4049 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4051 Copies the file <em class="parameter"><code>source</code></em> to the location specified by <em class="parameter"><code>destination</code></em>.
4052 Can not handle recursive copies of directories.
4055 If the flag <a class="link" href="GFile.html#G-FILE-COPY-OVERWRITE:CAPS"><span class="type">G_FILE_COPY_OVERWRITE</span></a> is specified an already
4056 existing <em class="parameter"><code>destination</code></em> file is overwritten.
4059 If the flag <a class="link" href="GFile.html#G-FILE-COPY-NOFOLLOW-SYMLINKS:CAPS"><span class="type">G_FILE_COPY_NOFOLLOW_SYMLINKS</span></a> is specified then symlinks
4060 will be copied as symlinks, otherwise the target of the
4061 <em class="parameter"><code>source</code></em> symlink will be copied.
4064 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4065 triggering the cancellable object from another thread. If the operation
4066 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4069 If <em class="parameter"><code>progress_callback</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be monitored by
4070 setting this to a <a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> function. <em class="parameter"><code>progress_callback_data</code></em>
4071 will be passed to this function. It is guaranteed that this callback will
4072 be called after all data has been transferred with the total number of bytes
4073 copied during the operation.
4076 If the <em class="parameter"><code>source</code></em> file does not exist then the G_IO_ERROR_NOT_FOUND
4077 error is returned, independent on the status of the <em class="parameter"><code>destination</code></em>.
4080 If <a class="link" href="GFile.html#G-FILE-COPY-OVERWRITE:CAPS"><span class="type">G_FILE_COPY_OVERWRITE</span></a> is not specified and the target exists, then the
4081 error G_IO_ERROR_EXISTS is returned.
4084 If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
4085 error is returned. If trying to overwrite a directory with a directory the
4086 G_IO_ERROR_WOULD_MERGE error is returned.
4089 If the source is a directory and the target does not exist, or
4090 <a class="link" href="GFile.html#G-FILE-COPY-OVERWRITE:CAPS"><span class="type">G_FILE_COPY_OVERWRITE</span></a> is specified and the target is a file, then the
4091 G_IO_ERROR_WOULD_RECURSE error is returned.
4094 If you are interested in copying the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> object itself (not the on-disk
4095 file), see <a class="link" href="GFile.html#g-file-dup" title="g_file_dup ()"><code class="function">g_file_dup()</code></a>.
4097 <div class="variablelist"><table border="0">
4098 <col align="left" valign="top">
4101 <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
4102 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4105 <td><p><span class="term"><em class="parameter"><code>destination</code></em> :</span></p></td>
4106 <td>destination <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
4110 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4111 <td>set of <a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a>
4115 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4116 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4120 <td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
4121 <td>function to callback with
4122 progress information, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if progress information is not needed. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
4126 <td><p><span class="term"><em class="parameter"><code>progress_callback_data</code></em> :</span></p></td>
4127 <td>user data to pass to <em class="parameter"><code>progress_callback</code></em>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
4131 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4133 <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to set on error, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4137 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4139 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4145 <div class="refsect2">
4146 <a name="g-file-copy-async"></a><h3>g_file_copy_async ()</h3>
4147 <pre class="programlisting"><span class="returnvalue">void</span> g_file_copy_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
4148 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
4149 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
4150 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
4151 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4152 <em class="parameter"><code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> progress_callback</code></em>,
4153 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_callback_data</code></em>,
4154 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
4155 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
4157 Copies the file <em class="parameter"><code>source</code></em> to the location specified by <em class="parameter"><code>destination</code></em>
4158 asynchronously. For details of the behaviour, see <a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()"><code class="function">g_file_copy()</code></a>.
4161 If <em class="parameter"><code>progress_callback</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then that function that will be called
4162 just like in <a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()"><code class="function">g_file_copy()</code></a>, however the callback will run in the main loop,
4163 not in the thread that is doing the I/O operation.
4166 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
4167 <a class="link" href="GFile.html#g-file-copy-finish" title="g_file_copy_finish ()"><code class="function">g_file_copy_finish()</code></a> to get the result of the operation.
4169 <div class="variablelist"><table border="0">
4170 <col align="left" valign="top">
4173 <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
4174 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4177 <td><p><span class="term"><em class="parameter"><code>destination</code></em> :</span></p></td>
4178 <td>destination <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
4182 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4183 <td>set of <a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a>
4187 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
4188 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
4192 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4193 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4197 <td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
4198 <td>function to callback with progress
4199 information, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if progress information is not needed. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4203 <td><p><span class="term"><em class="parameter"><code>progress_callback_data</code></em> :</span></p></td>
4204 <td>user data to pass to <em class="parameter"><code>progress_callback</code></em>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
4208 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4209 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied</td>
4212 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4213 <td>the data to pass to callback function</td>
4219 <div class="refsect2">
4220 <a name="g-file-copy-finish"></a><h3>g_file_copy_finish ()</h3>
4221 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_copy_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4222 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
4223 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4225 Finishes copying the file started with
4226 <a class="link" href="GFile.html#g-file-copy-async" title="g_file_copy_async ()"><code class="function">g_file_copy_async()</code></a>.
4228 <div class="variablelist"><table border="0">
4229 <col align="left" valign="top">
4232 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4233 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4236 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
4237 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
4240 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4241 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4245 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4246 <td>a <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</td>
4252 <div class="refsect2">
4253 <a name="g-file-move"></a><h3>g_file_move ()</h3>
4254 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_move (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
4255 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
4256 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
4257 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4258 <em class="parameter"><code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> progress_callback</code></em>,
4259 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_callback_data</code></em>,
4260 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4262 Tries to move the file or directory <em class="parameter"><code>source</code></em> to the location specified by <em class="parameter"><code>destination</code></em>.
4263 If native move operations are supported then this is used, otherwise a copy + delete
4264 fallback is used. The native implementation may support moving directories (for instance
4265 on moves inside the same filesystem), but the fallback code does not.
4268 If the flag <a class="link" href="GFile.html#G-FILE-COPY-OVERWRITE:CAPS"><span class="type">G_FILE_COPY_OVERWRITE</span></a> is specified an already
4269 existing <em class="parameter"><code>destination</code></em> file is overwritten.
4272 If the flag <a class="link" href="GFile.html#G-FILE-COPY-NOFOLLOW-SYMLINKS:CAPS"><span class="type">G_FILE_COPY_NOFOLLOW_SYMLINKS</span></a> is specified then symlinks
4273 will be copied as symlinks, otherwise the target of the
4274 <em class="parameter"><code>source</code></em> symlink will be copied.
4277 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4278 triggering the cancellable object from another thread. If the operation
4279 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4282 If <em class="parameter"><code>progress_callback</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be monitored by
4283 setting this to a <a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> function. <em class="parameter"><code>progress_callback_data</code></em>
4284 will be passed to this function. It is guaranteed that this callback will
4285 be called after all data has been transferred with the total number of bytes
4286 copied during the operation.
4289 If the <em class="parameter"><code>source</code></em> file does not exist then the G_IO_ERROR_NOT_FOUND
4290 error is returned, independent on the status of the <em class="parameter"><code>destination</code></em>.
4293 If <a class="link" href="GFile.html#G-FILE-COPY-OVERWRITE:CAPS"><span class="type">G_FILE_COPY_OVERWRITE</span></a> is not specified and the target exists, then the
4294 error G_IO_ERROR_EXISTS is returned.
4297 If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
4298 error is returned. If trying to overwrite a directory with a directory the
4299 G_IO_ERROR_WOULD_MERGE error is returned.
4302 If the source is a directory and the target does not exist, or <a class="link" href="GFile.html#G-FILE-COPY-OVERWRITE:CAPS"><span class="type">G_FILE_COPY_OVERWRITE</span></a> is
4303 specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
4304 may be returned (if the native move operation isn't available).
4306 <div class="variablelist"><table border="0">
4307 <col align="left" valign="top">
4310 <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
4312 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> pointing to the source location.</td>
4315 <td><p><span class="term"><em class="parameter"><code>destination</code></em> :</span></p></td>
4317 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> pointing to the destination location.</td>
4320 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4321 <td>set of <a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a>.</td>
4324 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4325 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4329 <td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
4331 <a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()"><span class="type">GFileProgressCallback</span></a> function for updates. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
4335 <td><p><span class="term"><em class="parameter"><code>progress_callback_data</code></em> :</span></p></td>
4336 <td>gpointer to user data for the callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
4340 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4342 <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for returning error conditions, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4346 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4348 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful move, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4354 <div class="refsect2">
4355 <a name="g-file-make-directory"></a><h3>g_file_make_directory ()</h3>
4356 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_make_directory (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4357 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4358 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4360 Creates a directory. Note that this will only create a child directory of
4361 the immediate parent directory of the path or URI given by the <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>. To
4362 recursively create directories, see <a class="link" href="GFile.html#g-file-make-directory-with-parents" title="g_file_make_directory_with_parents ()"><code class="function">g_file_make_directory_with_parents()</code></a>.
4363 This function will fail if the parent directory does not exist, setting
4364 <em class="parameter"><code>error</code></em> to <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-FOUND:CAPS"><code class="literal">G_IO_ERROR_NOT_FOUND</code></a>. If the file system doesn't support creating
4365 directories, this function will fail, setting <em class="parameter"><code>error</code></em> to
4366 <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a>.
4369 For a local <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> the newly created directory will have the default
4370 (current) ownership and permissions of the current process.
4373 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4374 triggering the cancellable object from another thread. If the operation
4375 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4377 <div class="variablelist"><table border="0">
4378 <col align="left" valign="top">
4381 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4382 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4385 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4386 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4390 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4391 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4395 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4397 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful creation, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4403 <div class="refsect2">
4404 <a name="g-file-make-directory-with-parents"></a><h3>g_file_make_directory_with_parents ()</h3>
4405 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_make_directory_with_parents (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4406 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4407 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4409 Creates a directory and any parent directories that may not exist similar to
4410 'mkdir -p'. If the file system does not support creating directories, this
4411 function will fail, setting <em class="parameter"><code>error</code></em> to <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a>. If the
4412 directory itself already exists, this function will fail setting <em class="parameter"><code>error</code></em>
4413 to <a class="link" href="gio-GIOError.html#G-IO-ERROR-EXISTS:CAPS"><code class="literal">G_IO_ERROR_EXISTS</code></a>, unlike the similar <a href="./../glib/glib/glib-File-Utilities.html#g-mkdir-with-parents"><code class="function">g_mkdir_with_parents()</code></a>.
4416 For a local <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> the newly created directories will have the default
4417 (current) ownership and permissions of the current process.
4420 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4421 triggering the cancellable object from another thread. If the operation
4422 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4424 <div class="variablelist"><table border="0">
4425 <col align="left" valign="top">
4428 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4429 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4432 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4433 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4437 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4438 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4442 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4444 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if all directories have been successfully created, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
4449 <p class="since">Since 2.18</p>
4452 <div class="refsect2">
4453 <a name="g-file-make-symbolic-link"></a><h3>g_file_make_symbolic_link ()</h3>
4454 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_make_symbolic_link (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4455 <em class="parameter"><code>const <span class="type">char</span> *symlink_value</code></em>,
4456 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4457 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4459 Creates a symbolic link named <em class="parameter"><code>file</code></em> which contains the string
4460 <em class="parameter"><code>symlink_value</code></em>.
4463 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4464 triggering the cancellable object from another thread. If the operation
4465 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4467 <div class="variablelist"><table border="0">
4468 <col align="left" valign="top">
4471 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4472 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> with the name of the symlink to create</td>
4475 <td><p><span class="term"><em class="parameter"><code>symlink_value</code></em> :</span></p></td>
4476 <td>a string with the path for the target of the new symlink</td>
4479 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4480 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4484 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4485 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.</td>
4488 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4490 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on the creation of a new symlink, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4496 <div class="refsect2">
4497 <a name="g-file-query-settable-attributes"></a><h3>g_file_query_settable_attributes ()</h3>
4498 <pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * g_file_query_settable_attributes
4499 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4500 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4501 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4503 Obtain the list of settable attributes for the file.
4506 Returns the type and full attribute name of all the attributes
4507 that can be set on this file. This doesn't mean setting it will always
4508 succeed though, you might get an access failure, or some specific
4509 file may not support a specific attribute.
4512 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4513 triggering the cancellable object from another thread. If the operation
4514 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4516 <div class="variablelist"><table border="0">
4517 <col align="left" valign="top">
4520 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4521 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4524 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4525 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4529 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4530 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4534 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4535 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> describing the settable attributes.
4536 When you are done with it, release it with <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-unref" title="g_file_attribute_info_list_unref ()"><code class="function">g_file_attribute_info_list_unref()</code></a>
4543 <div class="refsect2">
4544 <a name="g-file-query-writable-namespaces"></a><h3>g_file_query_writable_namespaces ()</h3>
4545 <pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * g_file_query_writable_namespaces
4546 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4547 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4548 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4550 Obtain the list of attribute namespaces where new attributes
4551 can be created by a user. An example of this is extended
4552 attributes (in the "xattr" namespace).
4555 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4556 triggering the cancellable object from another thread. If the operation
4557 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4559 <div class="variablelist"><table border="0">
4560 <col align="left" valign="top">
4563 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4564 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4567 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4568 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4572 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4573 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4577 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4578 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> describing the writable namespaces.
4579 When you are done with it, release it with <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-unref" title="g_file_attribute_info_list_unref ()"><code class="function">g_file_attribute_info_list_unref()</code></a>
4586 <div class="refsect2">
4587 <a name="g-file-set-attribute"></a><h3>g_file_set_attribute ()</h3>
4588 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4589 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
4590 <em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> type</code></em>,
4591 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> value_p</code></em>,
4592 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4593 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4594 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4596 Sets an attribute in the file with attribute name <em class="parameter"><code>attribute</code></em> to <em class="parameter"><code>value</code></em>.
4599 Some attributes can be unset by setting <em class="parameter"><code>attribute</code></em> to
4600 <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INVALID:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INVALID</code></a> and <em class="parameter"><code>value_p</code></em> to <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4603 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4604 triggering the cancellable object from another thread. If the operation
4605 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4607 <div class="variablelist"><table border="0">
4608 <col align="left" valign="top">
4611 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4612 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4615 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
4616 <td>a string containing the attribute's name.</td>
4619 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
4620 <td>The type of the attribute</td>
4623 <td><p><span class="term"><em class="parameter"><code>value_p</code></em> :</span></p></td>
4624 <td>a pointer to the value (or the pointer itself if the type is a pointer type). <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4628 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4629 <td>a set of <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
4632 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4633 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4637 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4638 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4642 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4644 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attribute was set, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4650 <div class="refsect2">
4651 <a name="g-file-set-attributes-from-info"></a><h3>g_file_set_attributes_from_info ()</h3>
4652 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attributes_from_info (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4653 <em class="parameter"><code><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> *info</code></em>,
4654 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4655 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4656 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4658 Tries to set all attributes in the <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> on the target values,
4659 not stopping on the first error.
4662 If there is any error during this operation then <em class="parameter"><code>error</code></em> will be set to
4663 the first error. Error on particular fields are flagged by setting
4664 the "status" field in the attribute value to
4665 <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-STATUS-ERROR-SETTING:CAPS"><code class="literal">G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING</code></a>, which means you can also detect
4669 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4670 triggering the cancellable object from another thread. If the operation
4671 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4673 <div class="variablelist"><table border="0">
4674 <col align="left" valign="top">
4677 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4678 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4681 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
4682 <td>a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>.</td>
4685 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4686 <td><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a></td>
4689 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4690 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4694 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4695 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4699 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4701 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if there was any error, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4707 <div class="refsect2">
4708 <a name="g-file-set-attributes-async"></a><h3>g_file_set_attributes_async ()</h3>
4709 <pre class="programlisting"><span class="returnvalue">void</span> g_file_set_attributes_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4710 <em class="parameter"><code><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> *info</code></em>,
4711 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4712 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
4713 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4714 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
4715 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
4717 Asynchronously sets the attributes of <em class="parameter"><code>file</code></em> with <em class="parameter"><code>info</code></em>.
4720 For more details, see <a class="link" href="GFile.html#g-file-set-attributes-from-info" title="g_file_set_attributes_from_info ()"><code class="function">g_file_set_attributes_from_info()</code></a> which is
4721 the synchronous version of this call.
4724 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
4725 <a class="link" href="GFile.html#g-file-set-attributes-finish" title="g_file_set_attributes_finish ()"><code class="function">g_file_set_attributes_finish()</code></a> to get the result of the operation.
4727 <div class="variablelist"><table border="0">
4728 <col align="left" valign="top">
4731 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4732 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4735 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
4736 <td>a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>.</td>
4739 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4740 <td>a <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
4743 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
4744 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
4745 of the request.</td>
4748 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4749 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4753 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4754 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
4758 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4759 <td>a <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
4766 <div class="refsect2">
4767 <a name="g-file-set-attributes-finish"></a><h3>g_file_set_attributes_finish ()</h3>
4768 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attributes_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4769 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
4770 <em class="parameter"><code><a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> **info</code></em>,
4771 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4773 Finishes setting an attribute started in <a class="link" href="GFile.html#g-file-set-attributes-async" title="g_file_set_attributes_async ()"><code class="function">g_file_set_attributes_async()</code></a>.
4775 <div class="variablelist"><table border="0">
4776 <col align="left" valign="top">
4779 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4780 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4783 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
4784 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
4787 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
4788 <td>a <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
4792 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4793 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4797 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4799 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes were set correctly, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4805 <div class="refsect2">
4806 <a name="g-file-set-attribute-string"></a><h3>g_file_set_attribute_string ()</h3>
4807 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute_string (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4808 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
4809 <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
4810 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4811 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4812 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4814 Sets <em class="parameter"><code>attribute</code></em> of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-STRING:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_STRING</code></a> to <em class="parameter"><code>value</code></em>.
4815 If <em class="parameter"><code>attribute</code></em> is of a different type, this operation will fail.
4818 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4819 triggering the cancellable object from another thread. If the operation
4820 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4822 <div class="variablelist"><table border="0">
4823 <col align="left" valign="top">
4826 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4827 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4830 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
4831 <td>a string containing the attribute's name.</td>
4834 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
4835 <td>a string containing the attribute's value.</td>
4838 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4840 <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
4843 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4844 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4848 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4849 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4853 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4855 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>attribute</code></em> was successfully set, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4861 <div class="refsect2">
4862 <a name="g-file-set-attribute-byte-string"></a><h3>g_file_set_attribute_byte_string ()</h3>
4863 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute_byte_string (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4864 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
4865 <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
4866 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4867 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4868 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4870 Sets <em class="parameter"><code>attribute</code></em> of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-BYTE-STRING:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_BYTE_STRING</code></a> to <em class="parameter"><code>value</code></em>.
4871 If <em class="parameter"><code>attribute</code></em> is of a different type, this operation will fail,
4872 returning <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
4875 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4876 triggering the cancellable object from another thread. If the operation
4877 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4879 <div class="variablelist"><table border="0">
4880 <col align="left" valign="top">
4883 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4884 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4887 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
4888 <td>a string containing the attribute's name.</td>
4891 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
4892 <td>a string containing the attribute's new value.</td>
4895 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4896 <td>a <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
4899 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4900 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4904 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4905 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4909 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4911 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>attribute</code></em> was successfully set to <em class="parameter"><code>value</code></em>
4912 in the <em class="parameter"><code>file</code></em>, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4918 <div class="refsect2">
4919 <a name="g-file-set-attribute-uint32"></a><h3>g_file_set_attribute_uint32 ()</h3>
4920 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute_uint32 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4921 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
4922 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>,
4923 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4924 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4925 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4927 Sets <em class="parameter"><code>attribute</code></em> of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-UINT32:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_UINT32</code></a> to <em class="parameter"><code>value</code></em>.
4928 If <em class="parameter"><code>attribute</code></em> is of a different type, this operation will fail.
4931 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4932 triggering the cancellable object from another thread. If the operation
4933 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4935 <div class="variablelist"><table border="0">
4936 <col align="left" valign="top">
4939 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4940 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4943 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
4944 <td>a string containing the attribute's name.</td>
4947 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
4948 <td>a <a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> containing the attribute's new value.</td>
4951 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
4952 <td>a <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
4955 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
4956 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
4960 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4961 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4965 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4967 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>attribute</code></em> was successfully set to <em class="parameter"><code>value</code></em>
4968 in the <em class="parameter"><code>file</code></em>, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
4974 <div class="refsect2">
4975 <a name="g-file-set-attribute-int32"></a><h3>g_file_set_attribute_int32 ()</h3>
4976 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute_int32 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
4977 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
4978 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> value</code></em>,
4979 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
4980 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
4981 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4983 Sets <em class="parameter"><code>attribute</code></em> of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INT32:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INT32</code></a> to <em class="parameter"><code>value</code></em>.
4984 If <em class="parameter"><code>attribute</code></em> is of a different type, this operation will fail.
4987 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
4988 triggering the cancellable object from another thread. If the operation
4989 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
4991 <div class="variablelist"><table border="0">
4992 <col align="left" valign="top">
4995 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
4996 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
4999 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
5000 <td>a string containing the attribute's name.</td>
5003 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
5004 <td>a <a href="./../glib/glib/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> containing the attribute's new value.</td>
5007 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5008 <td>a <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
5011 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5012 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5016 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5017 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5021 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5023 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>attribute</code></em> was successfully set to <em class="parameter"><code>value</code></em>
5024 in the <em class="parameter"><code>file</code></em>, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
5030 <div class="refsect2">
5031 <a name="g-file-set-attribute-uint64"></a><h3>g_file_set_attribute_uint64 ()</h3>
5032 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute_uint64 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5033 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
5034 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> value</code></em>,
5035 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
5036 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5037 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5039 Sets <em class="parameter"><code>attribute</code></em> of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-UINT64:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_UINT64</code></a> to <em class="parameter"><code>value</code></em>.
5040 If <em class="parameter"><code>attribute</code></em> is of a different type, this operation will fail.
5043 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5044 triggering the cancellable object from another thread. If the operation
5045 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5047 <div class="variablelist"><table border="0">
5048 <col align="left" valign="top">
5051 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5052 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5055 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
5056 <td>a string containing the attribute's name.</td>
5059 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
5060 <td>a <a href="./../glib/glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> containing the attribute's new value.</td>
5063 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5064 <td>a <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
5067 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5068 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5072 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5073 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5077 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5079 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>attribute</code></em> was successfully set to <em class="parameter"><code>value</code></em>
5080 in the <em class="parameter"><code>file</code></em>, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
5086 <div class="refsect2">
5087 <a name="g-file-set-attribute-int64"></a><h3>g_file_set_attribute_int64 ()</h3>
5088 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_set_attribute_int64 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5089 <em class="parameter"><code>const <span class="type">char</span> *attribute</code></em>,
5090 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> value</code></em>,
5091 <em class="parameter"><code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a> flags</code></em>,
5092 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5093 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5095 Sets <em class="parameter"><code>attribute</code></em> of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INT64:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INT64</code></a> to <em class="parameter"><code>value</code></em>.
5096 If <em class="parameter"><code>attribute</code></em> is of a different type, this operation will fail.
5099 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5100 triggering the cancellable object from another thread. If the operation
5101 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5103 <div class="variablelist"><table border="0">
5104 <col align="left" valign="top">
5107 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5108 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5111 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
5112 <td>a string containing the attribute's name.</td>
5115 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
5116 <td>a <a href="./../glib/glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> containing the attribute's new value.</td>
5119 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5120 <td>a <a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags"><span class="type">GFileQueryInfoFlags</span></a>.</td>
5123 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5124 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5128 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5129 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5133 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5135 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>attribute</code></em> was successfully set, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
5141 <div class="refsect2">
5142 <a name="g-file-mount-mountable"></a><h3>g_file_mount_mountable ()</h3>
5143 <pre class="programlisting"><span class="returnvalue">void</span> g_file_mount_mountable (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5144 <em class="parameter"><code><a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags"><span class="type">GMountMountFlags</span></a> flags</code></em>,
5145 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
5146 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5147 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5148 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5150 Mounts a file of type G_FILE_TYPE_MOUNTABLE.
5151 Using <em class="parameter"><code>mount_operation</code></em>, you can request callbacks when, for instance,
5152 passwords are needed during authentication.
5155 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5156 triggering the cancellable object from another thread. If the operation
5157 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5160 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
5161 <a class="link" href="GFile.html#g-file-mount-mountable-finish" title="g_file_mount_mountable_finish ()"><code class="function">g_file_mount_mountable_finish()</code></a> to get the result of the operation.
5163 <div class="variablelist"><table border="0">
5164 <col align="left" valign="top">
5167 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5168 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5171 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5172 <td>flags affecting the operation</td>
5175 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
5176 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5180 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5181 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5185 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5186 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5190 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5191 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
5198 <div class="refsect2">
5199 <a name="g-file-mount-mountable-finish"></a><h3>g_file_mount_mountable_finish ()</h3>
5200 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * g_file_mount_mountable_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5201 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5202 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5204 Finishes a mount operation. See <a class="link" href="GFile.html#g-file-mount-mountable" title="g_file_mount_mountable ()"><code class="function">g_file_mount_mountable()</code></a> for details.
5207 Finish an asynchronous mount operation that was started
5208 with <a class="link" href="GFile.html#g-file-mount-mountable" title="g_file_mount_mountable ()"><code class="function">g_file_mount_mountable()</code></a>.
5210 <div class="variablelist"><table border="0">
5211 <col align="left" valign="top">
5214 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5215 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5218 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5219 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5222 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5223 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5227 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5228 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
5229 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
5236 <div class="refsect2">
5237 <a name="g-file-unmount-mountable"></a><h3>g_file_unmount_mountable ()</h3>
5238 <pre class="programlisting"><span class="returnvalue">void</span> g_file_unmount_mountable (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5239 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
5240 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5241 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5242 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5243 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
5244 <h3 class="title">Warning</h3>
5245 <p><code class="literal">g_file_unmount_mountable</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()"><code class="function">g_file_unmount_mountable_with_operation()</code></a> instead.</p>
5248 Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
5251 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5252 triggering the cancellable object from another thread. If the operation
5253 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5256 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
5257 <a class="link" href="GFile.html#g-file-unmount-mountable-finish" title="g_file_unmount_mountable_finish ()"><code class="function">g_file_unmount_mountable_finish()</code></a> to get the result of the operation.
5259 <div class="variablelist"><table border="0">
5260 <col align="left" valign="top">
5263 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5264 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5267 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5268 <td>flags affecting the operation</td>
5271 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5272 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5276 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5277 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5281 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5282 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
5289 <div class="refsect2">
5290 <a name="g-file-unmount-mountable-finish"></a><h3>g_file_unmount_mountable_finish ()</h3>
5291 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_unmount_mountable_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5292 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5293 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5294 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
5295 <h3 class="title">Warning</h3>
5296 <p><code class="literal">g_file_unmount_mountable_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation-finish" title="g_file_unmount_mountable_with_operation_finish ()"><code class="function">g_file_unmount_mountable_with_operation_finish()</code></a> instead.</p>
5299 Finishes an unmount operation, see <a class="link" href="GFile.html#g-file-unmount-mountable" title="g_file_unmount_mountable ()"><code class="function">g_file_unmount_mountable()</code></a> for details.
5302 Finish an asynchronous unmount operation that was started
5303 with <a class="link" href="GFile.html#g-file-unmount-mountable" title="g_file_unmount_mountable ()"><code class="function">g_file_unmount_mountable()</code></a>.
5305 <div class="variablelist"><table border="0">
5306 <col align="left" valign="top">
5309 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5310 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5313 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5314 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5317 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5318 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5322 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5324 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5331 <div class="refsect2">
5332 <a name="g-file-unmount-mountable-with-operation"></a><h3>g_file_unmount_mountable_with_operation ()</h3>
5333 <pre class="programlisting"><span class="returnvalue">void</span> g_file_unmount_mountable_with_operation
5334 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5335 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
5336 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
5337 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5338 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5339 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5341 Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
5344 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5345 triggering the cancellable object from another thread. If the operation
5346 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5349 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
5350 <a class="link" href="GFile.html#g-file-unmount-mountable-finish" title="g_file_unmount_mountable_finish ()"><code class="function">g_file_unmount_mountable_finish()</code></a> to get the result of the operation.
5352 <div class="variablelist"><table border="0">
5353 <col align="left" valign="top">
5356 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5357 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5360 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5361 <td>flags affecting the operation</td>
5364 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
5365 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5369 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5370 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5374 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5375 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5379 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5380 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
5385 <p class="since">Since 2.22</p>
5388 <div class="refsect2">
5389 <a name="g-file-unmount-mountable-with-operation-finish"></a><h3>g_file_unmount_mountable_with_operation_finish ()</h3>
5390 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_unmount_mountable_with_operation_finish
5391 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5392 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5393 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5395 Finishes an unmount operation, see <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()"><code class="function">g_file_unmount_mountable_with_operation()</code></a> for details.
5398 Finish an asynchronous unmount operation that was started
5399 with <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()"><code class="function">g_file_unmount_mountable_with_operation()</code></a>.
5401 <div class="variablelist"><table border="0">
5402 <col align="left" valign="top">
5405 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5406 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5409 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5410 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5413 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5414 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5418 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5420 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5425 <p class="since">Since 2.22</p>
5428 <div class="refsect2">
5429 <a name="g-file-eject-mountable"></a><h3>g_file_eject_mountable ()</h3>
5430 <pre class="programlisting"><span class="returnvalue">void</span> g_file_eject_mountable (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5431 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
5432 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5433 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5434 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5435 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
5436 <h3 class="title">Warning</h3>
5437 <p><code class="literal">g_file_eject_mountable</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GFile.html#g-file-eject-mountable-with-operation" title="g_file_eject_mountable_with_operation ()"><code class="function">g_file_eject_mountable_with_operation()</code></a> instead.</p>
5440 Starts an asynchronous eject on a mountable.
5441 When this operation has completed, <em class="parameter"><code>callback</code></em> will be called with
5442 <em class="parameter"><code>user_user</code></em> data, and the operation can be finalized with
5443 <a class="link" href="GFile.html#g-file-eject-mountable-finish" title="g_file_eject_mountable_finish ()"><code class="function">g_file_eject_mountable_finish()</code></a>.
5446 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5447 triggering the cancellable object from another thread. If the operation
5448 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5450 <div class="variablelist"><table border="0">
5451 <col align="left" valign="top">
5454 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5455 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5458 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5459 <td>flags affecting the operation</td>
5462 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5463 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5467 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5468 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5472 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5473 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
5480 <div class="refsect2">
5481 <a name="g-file-eject-mountable-finish"></a><h3>g_file_eject_mountable_finish ()</h3>
5482 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_eject_mountable_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5483 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5484 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5485 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
5486 <h3 class="title">Warning</h3>
5487 <p><code class="literal">g_file_eject_mountable_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GFile.html#g-file-eject-mountable-with-operation-finish" title="g_file_eject_mountable_with_operation_finish ()"><code class="function">g_file_eject_mountable_with_operation_finish()</code></a> instead.</p>
5490 Finishes an asynchronous eject operation started by
5491 <a class="link" href="GFile.html#g-file-eject-mountable" title="g_file_eject_mountable ()"><code class="function">g_file_eject_mountable()</code></a>.
5493 <div class="variablelist"><table border="0">
5494 <col align="left" valign="top">
5497 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5498 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5501 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5502 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5505 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5506 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5510 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5512 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>file</code></em> was ejected successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5519 <div class="refsect2">
5520 <a name="g-file-eject-mountable-with-operation"></a><h3>g_file_eject_mountable_with_operation ()</h3>
5521 <pre class="programlisting"><span class="returnvalue">void</span> g_file_eject_mountable_with_operation
5522 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5523 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
5524 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
5525 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5526 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5527 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5529 Starts an asynchronous eject on a mountable.
5530 When this operation has completed, <em class="parameter"><code>callback</code></em> will be called with
5531 <em class="parameter"><code>user_user</code></em> data, and the operation can be finalized with
5532 <a class="link" href="GFile.html#g-file-eject-mountable-with-operation-finish" title="g_file_eject_mountable_with_operation_finish ()"><code class="function">g_file_eject_mountable_with_operation_finish()</code></a>.
5535 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5536 triggering the cancellable object from another thread. If the operation
5537 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5539 <div class="variablelist"><table border="0">
5540 <col align="left" valign="top">
5543 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5544 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5547 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5548 <td>flags affecting the operation</td>
5551 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
5552 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5556 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5557 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5561 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5562 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5566 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5567 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
5572 <p class="since">Since 2.22</p>
5575 <div class="refsect2">
5576 <a name="g-file-eject-mountable-with-operation-finish"></a><h3>g_file_eject_mountable_with_operation_finish ()</h3>
5577 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_eject_mountable_with_operation_finish
5578 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5579 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5580 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5582 Finishes an asynchronous eject operation started by
5583 <a class="link" href="GFile.html#g-file-eject-mountable-with-operation" title="g_file_eject_mountable_with_operation ()"><code class="function">g_file_eject_mountable_with_operation()</code></a>.
5585 <div class="variablelist"><table border="0">
5586 <col align="left" valign="top">
5589 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5590 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5593 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5594 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5597 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5598 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5602 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5604 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>file</code></em> was ejected successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5609 <p class="since">Since 2.22</p>
5612 <div class="refsect2">
5613 <a name="g-file-start-mountable"></a><h3>g_file_start_mountable ()</h3>
5614 <pre class="programlisting"><span class="returnvalue">void</span> g_file_start_mountable (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5615 <em class="parameter"><code><a class="link" href="GDrive.html#GDriveStartFlags" title="enum GDriveStartFlags"><span class="type">GDriveStartFlags</span></a> flags</code></em>,
5616 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *start_operation</code></em>,
5617 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5618 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5619 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5621 Starts a file of type G_FILE_TYPE_MOUNTABLE.
5622 Using <em class="parameter"><code>start_operation</code></em>, you can request callbacks when, for instance,
5623 passwords are needed during authentication.
5626 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5627 triggering the cancellable object from another thread. If the operation
5628 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5631 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
5632 <a class="link" href="GFile.html#g-file-mount-mountable-finish" title="g_file_mount_mountable_finish ()"><code class="function">g_file_mount_mountable_finish()</code></a> to get the result of the operation.
5634 <div class="variablelist"><table border="0">
5635 <col align="left" valign="top">
5638 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5639 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5642 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5643 <td>flags affecting the operation</td>
5646 <td><p><span class="term"><em class="parameter"><code>start_operation</code></em> :</span></p></td>
5647 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5651 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5652 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5656 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5657 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5661 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5662 <td>the data to pass to callback function</td>
5666 <p class="since">Since 2.22</p>
5669 <div class="refsect2">
5670 <a name="g-file-start-mountable-finish"></a><h3>g_file_start_mountable_finish ()</h3>
5671 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_start_mountable_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5672 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5673 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5675 Finishes a start operation. See <a class="link" href="GFile.html#g-file-start-mountable" title="g_file_start_mountable ()"><code class="function">g_file_start_mountable()</code></a> for details.
5678 Finish an asynchronous start operation that was started
5679 with <a class="link" href="GFile.html#g-file-start-mountable" title="g_file_start_mountable ()"><code class="function">g_file_start_mountable()</code></a>.
5681 <div class="variablelist"><table border="0">
5682 <col align="left" valign="top">
5685 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5686 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5689 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5690 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5693 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5694 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5698 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5700 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5705 <p class="since">Since 2.22</p>
5708 <div class="refsect2">
5709 <a name="g-file-stop-mountable"></a><h3>g_file_stop_mountable ()</h3>
5710 <pre class="programlisting"><span class="returnvalue">void</span> g_file_stop_mountable (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5711 <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
5712 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
5713 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5714 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5715 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5717 Stops a file of type G_FILE_TYPE_MOUNTABLE.
5720 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5721 triggering the cancellable object from another thread. If the operation
5722 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5725 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
5726 <a class="link" href="GFile.html#g-file-stop-mountable-finish" title="g_file_stop_mountable_finish ()"><code class="function">g_file_stop_mountable_finish()</code></a> to get the result of the operation.
5728 <div class="variablelist"><table border="0">
5729 <col align="left" valign="top">
5732 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5733 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5736 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5737 <td>flags affecting the operation</td>
5740 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
5741 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5745 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5746 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5750 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5751 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5755 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5756 <td>the data to pass to callback function</td>
5760 <p class="since">Since 2.22</p>
5763 <div class="refsect2">
5764 <a name="g-file-stop-mountable-finish"></a><h3>g_file_stop_mountable_finish ()</h3>
5765 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_stop_mountable_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5766 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5767 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5769 Finishes an stop operation, see <a class="link" href="GFile.html#g-file-stop-mountable" title="g_file_stop_mountable ()"><code class="function">g_file_stop_mountable()</code></a> for details.
5772 Finish an asynchronous stop operation that was started
5773 with <a class="link" href="GFile.html#g-file-stop-mountable" title="g_file_stop_mountable ()"><code class="function">g_file_stop_mountable()</code></a>.
5775 <div class="variablelist"><table border="0">
5776 <col align="left" valign="top">
5779 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5780 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5783 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5784 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5787 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5788 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5792 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5794 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5799 <p class="since">Since 2.22</p>
5802 <div class="refsect2">
5803 <a name="g-file-poll-mountable"></a><h3>g_file_poll_mountable ()</h3>
5804 <pre class="programlisting"><span class="returnvalue">void</span> g_file_poll_mountable (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5805 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5806 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5807 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5809 Polls a file of type G_FILE_TYPE_MOUNTABLE.
5812 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5813 triggering the cancellable object from another thread. If the operation
5814 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5817 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
5818 <a class="link" href="GFile.html#g-file-mount-mountable-finish" title="g_file_mount_mountable_finish ()"><code class="function">g_file_mount_mountable_finish()</code></a> to get the result of the operation.
5820 <div class="variablelist"><table border="0">
5821 <col align="left" valign="top">
5824 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5825 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5828 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5829 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
5832 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5833 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5837 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5838 <td>the data to pass to callback function</td>
5842 <p class="since">Since 2.22</p>
5845 <div class="refsect2">
5846 <a name="g-file-poll-mountable-finish"></a><h3>g_file_poll_mountable_finish ()</h3>
5847 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_poll_mountable_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5848 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5849 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5851 Finishes a poll operation. See <a class="link" href="GFile.html#g-file-poll-mountable" title="g_file_poll_mountable ()"><code class="function">g_file_poll_mountable()</code></a> for details.
5854 Finish an asynchronous poll operation that was polled
5855 with <a class="link" href="GFile.html#g-file-poll-mountable" title="g_file_poll_mountable ()"><code class="function">g_file_poll_mountable()</code></a>.
5857 <div class="variablelist"><table border="0">
5858 <col align="left" valign="top">
5861 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5862 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5865 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5866 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5869 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5870 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5874 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5876 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
5881 <p class="since">Since 2.22</p>
5884 <div class="refsect2">
5885 <a name="g-file-mount-enclosing-volume"></a><h3>g_file_mount_enclosing_volume ()</h3>
5886 <pre class="programlisting"><span class="returnvalue">void</span> g_file_mount_enclosing_volume (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *location</code></em>,
5887 <em class="parameter"><code><a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags"><span class="type">GMountMountFlags</span></a> flags</code></em>,
5888 <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
5889 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5890 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
5891 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
5893 Starts a <em class="parameter"><code>mount_operation</code></em>, mounting the volume that contains the file <em class="parameter"><code>location</code></em>.
5896 When this operation has completed, <em class="parameter"><code>callback</code></em> will be called with
5897 <em class="parameter"><code>user_user</code></em> data, and the operation can be finalized with
5898 <a class="link" href="GFile.html#g-file-mount-enclosing-volume-finish" title="g_file_mount_enclosing_volume_finish ()"><code class="function">g_file_mount_enclosing_volume_finish()</code></a>.
5901 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5902 triggering the cancellable object from another thread. If the operation
5903 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5905 <div class="variablelist"><table border="0">
5906 <col align="left" valign="top">
5909 <td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
5910 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5913 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
5914 <td>flags affecting the operation</td>
5917 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
5918 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5922 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
5923 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5927 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5928 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
5932 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5933 <td>the data to pass to callback function</td>
5939 <div class="refsect2">
5940 <a name="g-file-mount-enclosing-volume-finish"></a><h3>g_file_mount_enclosing_volume_finish ()</h3>
5941 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_mount_enclosing_volume_finish
5942 (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *location</code></em>,
5943 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
5944 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5946 Finishes a mount operation started by <a class="link" href="GFile.html#g-file-mount-enclosing-volume" title="g_file_mount_enclosing_volume ()"><code class="function">g_file_mount_enclosing_volume()</code></a>.
5948 <div class="variablelist"><table border="0">
5949 <col align="left" valign="top">
5952 <td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
5953 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
5956 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
5957 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
5960 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5961 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
5965 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5967 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error
5968 has occurred, this function will return <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
5969 appropriately if present.</td>
5975 <div class="refsect2">
5976 <a name="g-file-monitor-directory"></a><h3>g_file_monitor_directory ()</h3>
5977 <pre class="programlisting"><a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="returnvalue">GFileMonitor</span></a> * g_file_monitor_directory (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
5978 <em class="parameter"><code><a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a> flags</code></em>,
5979 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
5980 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
5982 Obtains a directory monitor for the given file.
5983 This may fail if directory monitoring is not supported.
5986 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
5987 triggering the cancellable object from another thread. If the operation
5988 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
5991 Virtual: monitor_dir
5993 <div class="variablelist"><table border="0">
5994 <col align="left" valign="top">
5997 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
5998 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6001 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6002 <td>a set of <a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a>.</td>
6005 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6006 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6010 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6011 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
6014 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6015 <td>a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> for the given <em class="parameter"><code>file</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6016 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6023 <div class="refsect2">
6024 <a name="g-file-monitor-file"></a><h3>g_file_monitor_file ()</h3>
6025 <pre class="programlisting"><a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="returnvalue">GFileMonitor</span></a> * g_file_monitor_file (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6026 <em class="parameter"><code><a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a> flags</code></em>,
6027 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6028 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6030 Obtains a file monitor for the given file. If no file notification
6031 mechanism exists, then regular polling of the file is used.
6034 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6035 triggering the cancellable object from another thread. If the operation
6036 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6038 <div class="variablelist"><table border="0">
6039 <col align="left" valign="top">
6042 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6043 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6046 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6047 <td>a set of <a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a>.</td>
6050 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6051 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6055 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6056 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
6059 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6060 <td>a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> for the given <em class="parameter"><code>file</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6061 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6068 <div class="refsect2">
6069 <a name="g-file-monitor"></a><h3>g_file_monitor ()</h3>
6070 <pre class="programlisting"><a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="returnvalue">GFileMonitor</span></a> * g_file_monitor (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6071 <em class="parameter"><code><a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a> flags</code></em>,
6072 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6073 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6075 Obtains a file or directory monitor for the given file, depending
6076 on the type of the file.
6079 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6080 triggering the cancellable object from another thread. If the operation
6081 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6083 <div class="variablelist"><table border="0">
6084 <col align="left" valign="top">
6087 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6088 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
6092 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6093 <td>a set of <a class="link" href="GFile.html#GFileMonitorFlags"><span class="type">GFileMonitorFlags</span></a>
6097 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6098 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6102 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6103 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6107 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6108 <td>a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> for the given <em class="parameter"><code>file</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6109 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6114 <p class="since">Since 2.18</p>
6117 <div class="refsect2">
6118 <a name="g-file-load-contents"></a><h3>g_file_load_contents ()</h3>
6119 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_load_contents (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6120 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6121 <em class="parameter"><code><span class="type">char</span> **contents</code></em>,
6122 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
6123 <em class="parameter"><code><span class="type">char</span> **etag_out</code></em>,
6124 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6126 Loads the content of the file into memory. The data is always
6127 zero-terminated, but this is not included in the resultant <em class="parameter"><code>length</code></em>.
6128 The returned <em class="parameter"><code>content</code></em> should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer
6132 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6133 triggering the cancellable object from another thread. If the operation
6134 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6136 <div class="variablelist"><table border="0">
6137 <col align="left" valign="top">
6140 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6141 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6144 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6145 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
6148 <td><p><span class="term"><em class="parameter"><code>contents</code></em> :</span></p></td>
6149 <td>a location to place the contents of the file. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
6153 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
6154 <td>a location to place the length of the contents of the file,
6155 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6159 <td><p><span class="term"><em class="parameter"><code>etag_out</code></em> :</span></p></td>
6160 <td>a location to place the current entity tag for the file,
6161 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6165 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6166 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6170 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6172 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>file</code></em>'s contents were successfully loaded.
6173 <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there were errors.</td>
6179 <div class="refsect2">
6180 <a name="g-file-load-contents-async"></a><h3>g_file_load_contents_async ()</h3>
6181 <pre class="programlisting"><span class="returnvalue">void</span> g_file_load_contents_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6182 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6183 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
6184 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
6186 Starts an asynchronous load of the <em class="parameter"><code>file</code></em>'s contents.
6189 For more details, see <a class="link" href="GFile.html#g-file-load-contents" title="g_file_load_contents ()"><code class="function">g_file_load_contents()</code></a> which is
6190 the synchronous version of this call.
6193 When the load operation has completed, <em class="parameter"><code>callback</code></em> will be called
6194 with <em class="parameter"><code>user</code></em> data. To finish the operation, call
6195 <a class="link" href="GFile.html#g-file-load-contents-finish" title="g_file_load_contents_finish ()"><code class="function">g_file_load_contents_finish()</code></a> with the <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> returned by
6196 the <em class="parameter"><code>callback</code></em>.
6199 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6200 triggering the cancellable object from another thread. If the operation
6201 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6203 <div class="variablelist"><table border="0">
6204 <col align="left" valign="top">
6207 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6208 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6211 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6212 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
6215 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
6216 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied</td>
6219 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
6220 <td>the data to pass to callback function</td>
6226 <div class="refsect2">
6227 <a name="g-file-load-contents-finish"></a><h3>g_file_load_contents_finish ()</h3>
6228 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_load_contents_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6229 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
6230 <em class="parameter"><code><span class="type">char</span> **contents</code></em>,
6231 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
6232 <em class="parameter"><code><span class="type">char</span> **etag_out</code></em>,
6233 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6235 Finishes an asynchronous load of the <em class="parameter"><code>file</code></em>'s contents.
6236 The contents are placed in <em class="parameter"><code>contents</code></em>, and <em class="parameter"><code>length</code></em> is set to the
6237 size of the <em class="parameter"><code>contents</code></em> string. The <em class="parameter"><code>content</code></em> should be freed with
6238 <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed. If <em class="parameter"><code>etag_out</code></em> is present, it will be
6239 set to the new entity tag for the <em class="parameter"><code>file</code></em>.
6241 <div class="variablelist"><table border="0">
6242 <col align="left" valign="top">
6245 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6246 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6249 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
6250 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
6253 <td><p><span class="term"><em class="parameter"><code>contents</code></em> :</span></p></td>
6254 <td>a location to place the contents of the file. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
6258 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
6259 <td>a location to place the length of the contents of the file,
6260 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6264 <td><p><span class="term"><em class="parameter"><code>etag_out</code></em> :</span></p></td>
6265 <td>a location to place the current entity tag for the file,
6266 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6270 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6271 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6275 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6277 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the load was successful. If <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <em class="parameter"><code>error</code></em> is
6278 present, it will be set appropriately.</td>
6284 <div class="refsect2">
6285 <a name="g-file-load-partial-contents-async"></a><h3>g_file_load_partial_contents_async ()</h3>
6286 <pre class="programlisting"><span class="returnvalue">void</span> g_file_load_partial_contents_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6287 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6288 <em class="parameter"><code><a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()"><span class="type">GFileReadMoreCallback</span></a> read_more_callback</code></em>,
6289 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
6290 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
6292 Reads the partial contents of a file. A <a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()"><span class="type">GFileReadMoreCallback</span></a> should be
6293 used to stop reading from the file when appropriate, else this function
6294 will behave exactly as <a class="link" href="GFile.html#g-file-load-contents-async" title="g_file_load_contents_async ()"><code class="function">g_file_load_contents_async()</code></a>. This operation
6295 can be finished by <a class="link" href="GFile.html#g-file-load-partial-contents-finish" title="g_file_load_partial_contents_finish ()"><code class="function">g_file_load_partial_contents_finish()</code></a>.
6298 Users of this function should be aware that <em class="parameter"><code>user_data</code></em> is passed to
6299 both the <em class="parameter"><code>read_more_callback</code></em> and the <em class="parameter"><code>callback</code></em>.
6302 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6303 triggering the cancellable object from another thread. If the operation
6304 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6306 <div class="variablelist"><table border="0">
6307 <col align="left" valign="top">
6310 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6311 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6314 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6315 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
6318 <td><p><span class="term"><em class="parameter"><code>read_more_callback</code></em> :</span></p></td>
6319 <td>a <a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()"><span class="type">GFileReadMoreCallback</span></a> to receive partial data and to specify whether further data should be read.</td>
6322 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
6323 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied</td>
6326 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
6327 <td>the data to pass to the callback functions.</td>
6333 <div class="refsect2">
6334 <a name="g-file-load-partial-contents-finish"></a><h3>g_file_load_partial_contents_finish ()</h3>
6335 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_load_partial_contents_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6336 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
6337 <em class="parameter"><code><span class="type">char</span> **contents</code></em>,
6338 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
6339 <em class="parameter"><code><span class="type">char</span> **etag_out</code></em>,
6340 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6342 Finishes an asynchronous partial load operation that was started
6343 with <a class="link" href="GFile.html#g-file-load-partial-contents-async" title="g_file_load_partial_contents_async ()"><code class="function">g_file_load_partial_contents_async()</code></a>. The data is always
6344 zero-terminated, but this is not included in the resultant <em class="parameter"><code>length</code></em>.
6345 The returned <em class="parameter"><code>content</code></em> should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer
6348 <div class="variablelist"><table border="0">
6349 <col align="left" valign="top">
6352 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6353 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6356 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
6357 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
6360 <td><p><span class="term"><em class="parameter"><code>contents</code></em> :</span></p></td>
6361 <td>a location to place the contents of the file. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
6365 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
6366 <td>a location to place the length of the contents of the file,
6367 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6371 <td><p><span class="term"><em class="parameter"><code>etag_out</code></em> :</span></p></td>
6372 <td>a location to place the current entity tag for the file,
6373 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6377 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6378 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6382 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6384 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the load was successful. If <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <em class="parameter"><code>error</code></em> is
6385 present, it will be set appropriately.</td>
6391 <div class="refsect2">
6392 <a name="g-file-replace-contents"></a><h3>g_file_replace_contents ()</h3>
6393 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_replace_contents (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6394 <em class="parameter"><code>const <span class="type">char</span> *contents</code></em>,
6395 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
6396 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
6397 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
6398 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
6399 <em class="parameter"><code><span class="type">char</span> **new_etag</code></em>,
6400 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6401 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6403 Replaces the contents of <em class="parameter"><code>file</code></em> with <em class="parameter"><code>contents</code></em> of <em class="parameter"><code>length</code></em> bytes.
6405 If <em class="parameter"><code>etag</code></em> is specified (not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) any existing file must have that etag, or
6406 the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-WRONG-ETAG:CAPS"><code class="literal">G_IO_ERROR_WRONG_ETAG</code></a> will be returned.
6409 If <em class="parameter"><code>make_backup</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to make a backup of <em class="parameter"><code>file</code></em>.
6412 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6413 triggering the cancellable object from another thread. If the operation
6414 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6417 The returned <em class="parameter"><code>new_etag</code></em> can be used to verify that the file hasn't changed the
6418 next time it is saved over.
6420 <div class="variablelist"><table border="0">
6421 <col align="left" valign="top">
6424 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6425 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6428 <td><p><span class="term"><em class="parameter"><code>contents</code></em> :</span></p></td>
6429 <td>a string containing the new contents for <em class="parameter"><code>file</code></em>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
6433 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
6434 <td>the length of <em class="parameter"><code>contents</code></em> in bytes.</td>
6437 <td><p><span class="term"><em class="parameter"><code>etag</code></em> :</span></p></td>
6438 <td>the old <a class="link" href="GFile.html#gfile-etag">entity tag</a>
6439 for the document, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6443 <td><p><span class="term"><em class="parameter"><code>make_backup</code></em> :</span></p></td>
6445 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created.</td>
6448 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6449 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
6452 <td><p><span class="term"><em class="parameter"><code>new_etag</code></em> :</span></p></td>
6453 <td>a location to a new <a class="link" href="GFile.html#gfile-etag">entity tag</a>
6454 for the document. This should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer
6455 needed, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
6459 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6460 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
6463 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6464 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6468 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6470 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error
6471 has occurred, this function will return <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
6472 appropriately if present.</td>
6478 <div class="refsect2">
6479 <a name="g-file-replace-contents-async"></a><h3>g_file_replace_contents_async ()</h3>
6480 <pre class="programlisting"><span class="returnvalue">void</span> g_file_replace_contents_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6481 <em class="parameter"><code>const <span class="type">char</span> *contents</code></em>,
6482 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
6483 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
6484 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
6485 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
6486 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6487 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
6488 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
6490 Starts an asynchronous replacement of <em class="parameter"><code>file</code></em> with the given
6491 <em class="parameter"><code>contents</code></em> of <em class="parameter"><code>length</code></em> bytes. <em class="parameter"><code>etag</code></em> will replace the document's
6495 When this operation has completed, <em class="parameter"><code>callback</code></em> will be called with
6496 <em class="parameter"><code>user_user</code></em> data, and the operation can be finalized with
6497 <a class="link" href="GFile.html#g-file-replace-contents-finish" title="g_file_replace_contents_finish ()"><code class="function">g_file_replace_contents_finish()</code></a>.
6500 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6501 triggering the cancellable object from another thread. If the operation
6502 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6505 If <em class="parameter"><code>make_backup</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to
6506 make a backup of <em class="parameter"><code>file</code></em>.
6508 <div class="variablelist"><table border="0">
6509 <col align="left" valign="top">
6512 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6513 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6516 <td><p><span class="term"><em class="parameter"><code>contents</code></em> :</span></p></td>
6517 <td>string of contents to replace the file with. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
6521 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
6522 <td>the length of <em class="parameter"><code>contents</code></em> in bytes.</td>
6525 <td><p><span class="term"><em class="parameter"><code>etag</code></em> :</span></p></td>
6526 <td>a new <a class="link" href="GFile.html#gfile-etag">entity tag</a> for the <em class="parameter"><code>file</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6530 <td><p><span class="term"><em class="parameter"><code>make_backup</code></em> :</span></p></td>
6532 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created.</td>
6535 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6536 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
6539 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6540 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
6543 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
6544 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied</td>
6547 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
6548 <td>the data to pass to callback function</td>
6554 <div class="refsect2">
6555 <a name="g-file-replace-contents-finish"></a><h3>g_file_replace_contents_finish ()</h3>
6556 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_replace_contents_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6557 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
6558 <em class="parameter"><code><span class="type">char</span> **new_etag</code></em>,
6559 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6561 Finishes an asynchronous replace of the given <em class="parameter"><code>file</code></em>. See
6562 <a class="link" href="GFile.html#g-file-replace-contents-async" title="g_file_replace_contents_async ()"><code class="function">g_file_replace_contents_async()</code></a>. Sets <em class="parameter"><code>new_etag</code></em> to the new entity
6563 tag for the document, if present.
6565 <div class="variablelist"><table border="0">
6566 <col align="left" valign="top">
6569 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6570 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6573 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
6574 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
6577 <td><p><span class="term"><em class="parameter"><code>new_etag</code></em> :</span></p></td>
6578 <td>a location of a new <a class="link" href="GFile.html#gfile-etag">entity tag</a>
6579 for the document. This should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no
6580 longer needed, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6584 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6585 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6589 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6591 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure.</td>
6597 <div class="refsect2">
6598 <a name="g-file-copy-attributes"></a><h3>g_file_copy_attributes ()</h3>
6599 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_copy_attributes (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *source</code></em>,
6600 <em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *destination</code></em>,
6601 <em class="parameter"><code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a> flags</code></em>,
6602 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6603 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6605 Copies the file attributes from <em class="parameter"><code>source</code></em> to <em class="parameter"><code>destination</code></em>.
6608 Normally only a subset of the file attributes are copied,
6609 those that are copies in a normal file copy operation
6610 (which for instance does not include e.g. owner). However
6611 if <a class="link" href="GFile.html#G-FILE-COPY-ALL-METADATA:CAPS"><span class="type">G_FILE_COPY_ALL_METADATA</span></a> is specified in <em class="parameter"><code>flags</code></em>, then
6612 all the metadata that is possible to copy is copied. This
6613 is useful when implementing move by copy + delete source.
6615 <div class="variablelist"><table border="0">
6616 <col align="left" valign="top">
6619 <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
6620 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> with attributes.</td>
6623 <td><p><span class="term"><em class="parameter"><code>destination</code></em> :</span></p></td>
6624 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to copy attributes to.</td>
6627 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6628 <td>a set of <a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags"><span class="type">GFileCopyFlags</span></a>.</td>
6631 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6632 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6636 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6637 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
6640 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6642 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes were copied successfully, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
6648 <div class="refsect2">
6649 <a name="g-file-create-readwrite"></a><h3>g_file_create_readwrite ()</h3>
6650 <pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * g_file_create_readwrite (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6651 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
6652 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6653 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6655 Creates a new file and returns a stream for reading and writing to it.
6656 The file must not already exist.
6659 By default files created are generally readable by everyone,
6660 but if you pass <a class="link" href="GFile.html#G-FILE-CREATE-PRIVATE:CAPS"><span class="type">G_FILE_CREATE_PRIVATE</span></a> in <em class="parameter"><code>flags</code></em> the file
6661 will be made readable only to the current user, to the level that
6662 is supported on the target filesystem.
6665 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6666 triggering the cancellable object from another thread. If the operation
6667 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6670 If a file or directory with this name already exists the <a class="link" href="gio-GIOError.html#G-IO-ERROR-EXISTS:CAPS"><code class="literal">G_IO_ERROR_EXISTS</code></a>
6671 error will be returned. Some file systems don't allow all file names,
6672 and may return an <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-FILENAME:CAPS"><code class="literal">G_IO_ERROR_INVALID_FILENAME</code></a> error, and if the name
6673 is too long, <a class="link" href="gio-GIOError.html#G-IO-ERROR-FILENAME-TOO-LONG:CAPS"><code class="literal">G_IO_ERROR_FILENAME_TOO_LONG</code></a> will be returned. Other errors
6674 are possible too, and depend on what kind of filesystem the file is on.
6677 Note that in many non-local file cases read and write streams are not
6678 supported, so make sure you really need to do read and write streaming,
6679 rather than just opening for reading or writing.
6681 <div class="variablelist"><table border="0">
6682 <col align="left" valign="top">
6685 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6686 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
6690 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6691 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>
6695 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6696 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6700 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6701 <td>return location for a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6705 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6706 <td>a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> for the newly created file, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6707 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6712 <p class="since">Since 2.22</p>
6715 <div class="refsect2">
6716 <a name="g-file-create-readwrite-async"></a><h3>g_file_create_readwrite_async ()</h3>
6717 <pre class="programlisting"><span class="returnvalue">void</span> g_file_create_readwrite_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6718 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
6719 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
6720 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6721 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
6722 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
6724 Asynchronously creates a new file and returns a stream for reading and
6725 writing to it. The file must not already exist.
6728 For more details, see <a class="link" href="GFile.html#g-file-create-readwrite" title="g_file_create_readwrite ()"><code class="function">g_file_create_readwrite()</code></a> which is
6729 the synchronous version of this call.
6732 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then
6733 call <a class="link" href="GFile.html#g-file-create-readwrite-finish" title="g_file_create_readwrite_finish ()"><code class="function">g_file_create_readwrite_finish()</code></a> to get the result of the operation.
6735 <div class="variablelist"><table border="0">
6736 <col align="left" valign="top">
6739 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6740 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
6744 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6745 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>
6749 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
6750 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
6754 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6755 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6759 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
6760 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
6764 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
6765 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
6770 <p class="since">Since 2.22</p>
6773 <div class="refsect2">
6774 <a name="g-file-create-readwrite-finish"></a><h3>g_file_create_readwrite_finish ()</h3>
6775 <pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * g_file_create_readwrite_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6776 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
6777 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6779 Finishes an asynchronous file create operation started with
6780 <a class="link" href="GFile.html#g-file-create-readwrite-async" title="g_file_create_readwrite_async ()"><code class="function">g_file_create_readwrite_async()</code></a>.
6782 <div class="variablelist"><table border="0">
6783 <col align="left" valign="top">
6786 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6787 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
6791 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
6792 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>
6796 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6797 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6801 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6802 <td>a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6803 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6808 <p class="since">Since 2.22</p>
6811 <div class="refsect2">
6812 <a name="g-file-open-readwrite"></a><h3>g_file_open_readwrite ()</h3>
6813 <pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * g_file_open_readwrite (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6814 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6815 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6817 Opens an existing file for reading and writing. The result is
6818 a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> that can be used to read and write the contents of the file.
6821 If <em class="parameter"><code>cancellable</code></em> is not <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
6822 triggering the cancellable object from another thread. If the operation
6823 was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
6826 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
6827 If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
6828 Other errors are possible too, and depend on what kind of filesystem the file is on.
6829 Note that in many non-local file cases read and write streams are not supported,
6830 so make sure you really need to do read and write streaming, rather than
6831 just opening for reading or writing.
6833 <div class="variablelist"><table border="0">
6834 <col align="left" valign="top">
6837 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6839 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to open</td>
6842 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6843 <td>a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6847 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6848 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6852 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6854 <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6855 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6860 <p class="since">Since 2.22</p>
6863 <div class="refsect2">
6864 <a name="g-file-open-readwrite-async"></a><h3>g_file_open_readwrite_async ()</h3>
6865 <pre class="programlisting"><span class="returnvalue">void</span> g_file_open_readwrite_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6866 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
6867 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6868 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
6869 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
6871 Asynchronously opens <em class="parameter"><code>file</code></em> for reading and writing.
6874 For more details, see <a class="link" href="GFile.html#g-file-open-readwrite" title="g_file_open_readwrite ()"><code class="function">g_file_open_readwrite()</code></a> which is
6875 the synchronous version of this call.
6878 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
6879 <a class="link" href="GFile.html#g-file-open-readwrite-finish" title="g_file_open_readwrite_finish ()"><code class="function">g_file_open_readwrite_finish()</code></a> to get the result of the operation.
6881 <div class="variablelist"><table border="0">
6882 <col align="left" valign="top">
6885 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6886 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6889 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
6890 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
6891 of the request.</td>
6894 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6895 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6899 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
6900 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
6904 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
6905 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
6910 <p class="since">Since 2.22</p>
6913 <div class="refsect2">
6914 <a name="g-file-open-readwrite-finish"></a><h3>g_file_open_readwrite_finish ()</h3>
6915 <pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * g_file_open_readwrite_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6916 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
6917 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6919 Finishes an asynchronous file read operation started with
6920 <a class="link" href="GFile.html#g-file-open-readwrite-async" title="g_file_open_readwrite_async ()"><code class="function">g_file_open_readwrite_async()</code></a>.
6922 <div class="variablelist"><table border="0">
6923 <col align="left" valign="top">
6926 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6927 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
6930 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
6931 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
6934 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
6935 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
6939 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
6940 <td>a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
6941 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
6946 <p class="since">Since 2.22</p>
6949 <div class="refsect2">
6950 <a name="g-file-replace-readwrite"></a><h3>g_file_replace_readwrite ()</h3>
6951 <pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * g_file_replace_readwrite (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
6952 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
6953 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
6954 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
6955 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
6956 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
6958 Returns an output stream for overwriting the file in readwrite mode,
6959 possibly creating a backup copy of the file first. If the file doesn't
6960 exist, it will be created.
6963 For details about the behaviour, see <a class="link" href="GFile.html#g-file-replace" title="g_file_replace ()"><code class="function">g_file_replace()</code></a> which does the same
6964 thing but returns an output stream only.
6967 Note that in many non-local file cases read and write streams are not
6968 supported, so make sure you really need to do read and write streaming,
6969 rather than just opening for reading or writing.
6971 <div class="variablelist"><table border="0">
6972 <col align="left" valign="top">
6975 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
6976 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>
6980 <td><p><span class="term"><em class="parameter"><code>etag</code></em> :</span></p></td>
6981 <td>an optional <a class="link" href="GFile.html#gfile-etag">entity tag</a> for the
6982 current <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
6986 <td><p><span class="term"><em class="parameter"><code>make_backup</code></em> :</span></p></td>
6988 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>
6991 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
6992 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>
6996 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
6997 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
7001 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
7002 <td>return location for a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
7006 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
7007 <td>a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
7008 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
7013 <p class="since">Since 2.22</p>
7016 <div class="refsect2">
7017 <a name="g-file-replace-readwrite-async"></a><h3>g_file_replace_readwrite_async ()</h3>
7018 <pre class="programlisting"><span class="returnvalue">void</span> g_file_replace_readwrite_async (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
7019 <em class="parameter"><code>const <span class="type">char</span> *etag</code></em>,
7020 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> make_backup</code></em>,
7021 <em class="parameter"><code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a> flags</code></em>,
7022 <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
7023 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
7024 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
7025 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
7027 Asynchronously overwrites the file in read-write mode, replacing the
7028 contents, possibly creating a backup copy of the file first.
7031 For more details, see <a class="link" href="GFile.html#g-file-replace-readwrite" title="g_file_replace_readwrite ()"><code class="function">g_file_replace_readwrite()</code></a> which is
7032 the synchronous version of this call.
7035 When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then
7036 call <a class="link" href="GFile.html#g-file-replace-readwrite-finish" title="g_file_replace_readwrite_finish ()"><code class="function">g_file_replace_readwrite_finish()</code></a> to get the result of the operation.
7038 <div class="variablelist"><table border="0">
7039 <col align="left" valign="top">
7042 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
7043 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
7046 <td><p><span class="term"><em class="parameter"><code>etag</code></em> :</span></p></td>
7047 <td>an <a class="link" href="GFile.html#gfile-etag">entity tag</a> for the
7048 current <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, or NULL to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
7052 <td><p><span class="term"><em class="parameter"><code>make_backup</code></em> :</span></p></td>
7054 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created.</td>
7057 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
7058 <td>a set of <a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags"><span class="type">GFileCreateFlags</span></a>.</td>
7061 <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
7062 <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
7063 of the request.</td>
7066 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
7067 <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
7071 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
7072 <td>a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
7076 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
7077 <td>the data to pass to callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
7082 <p class="since">Since 2.22</p>
7085 <div class="refsect2">
7086 <a name="g-file-replace-readwrite-finish"></a><h3>g_file_replace_readwrite_finish ()</h3>
7087 <pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="returnvalue">GFileIOStream</span></a> * g_file_replace_readwrite_finish (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>,
7088 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
7089 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
7091 Finishes an asynchronous file replace operation started with
7092 <a class="link" href="GFile.html#g-file-replace-readwrite-async" title="g_file_replace_readwrite_async ()"><code class="function">g_file_replace_readwrite_async()</code></a>.
7094 <div class="variablelist"><table border="0">
7095 <col align="left" valign="top">
7098 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
7099 <td>input <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
7102 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
7103 <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
7106 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
7107 <td>a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
7111 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
7112 <td>a <a class="link" href="GFileIOStream.html" title="GFileIOStream"><span class="type">GFileIOStream</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
7113 Free the returned object with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
7118 <p class="since">Since 2.22</p>
7121 <div class="refsect2">
7122 <a name="g-file-supports-thread-contexts"></a><h3>g_file_supports_thread_contexts ()</h3>
7123 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_supports_thread_contexts (<em class="parameter"><code><a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> *file</code></em>);</pre>
7125 Checks if <em class="parameter"><code>file</code></em> supports <GTKDOCLINK HREF="g-main-context-push-thread-default-context">thread-default
7126 contexts</GTKDOCLINK>. If this returns <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, you cannot perform
7127 asynchronous operations on <em class="parameter"><code>file</code></em> in a thread that has a
7128 thread-default context.
7130 <div class="variablelist"><table border="0">
7131 <col align="left" valign="top">
7134 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
7135 <td>a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.</td>
7138 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
7139 <td>Whether or not <em class="parameter"><code>file</code></em> supports thread-default contexts.</td>
7143 <p class="since">Since 2.22</p>
7146 <div class="refsect1">
7147 <a name="GFile.see-also"></a><h2>See Also</h2>
7148 <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>, <a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="type">GFileEnumerator</span></a>
7151 <div class="footer">
7153 Generated by GTK-Doc V1.18</div>