doc/html/gnome-vfs-gnome-vfs-file-basic-ops.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Basic File Operations</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.0"><meta name="generator" content="GTK-Doc V1.1 (XML mode)"><style type="text/css">
   2         .synopsis, .classsynopsis {
   3             background: #eeeeee;
   4             border: solid 1px #aaaaaa;
   5             padding: 0.5em;
   6         }
   7         .programlisting {
   8             background: #eeeeff;
   9             border: solid 1px #aaaaff;
  10             padding: 0.5em;
  11         }
  12         .variablelist {
  13             padding: 4px;
  14             margin-left: 3em;
  15         }
  16         .navigation {
  17             background: #ffeeee;
  18             border: solid 1px #ffaaaa;
  19             margin-top: 0.5em;
  20             margin-bottom: 0.5em;
  21         }
  22         .navigation a {
  23             color: #770000;
  24         }
  25         .navigation a:visited {
  26             color: #550000;
  27         }
  28         .navigation .title {
  29             font-size: 200%;
  30         }
  31       </style><link rel="home" href="index.html" title="GnomeVFS - Filesystem Abstraction library"><link rel="up" href="gnome-vfs-file-operations.html" title="File Handling"><link rel="previous" href="gnome-vfs-file-operations.html" title="File Handling"><link rel="next" href="gnome-vfs-gnome-vfs-file-rw-ops.html" title="Reading and Writing"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="gnome-vfs-file-operations.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="gnome-vfs-file-operations.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GnomeVFS - Filesystem Abstraction library</th><td><a accesskey="n" href="gnome-vfs-gnome-vfs-file-rw-ops.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="gnome-vfs-gnome-vfs-file-basic-ops"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2><span class="refentrytitle">Basic File Operations</span></h2><p>Basic File Operations &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
  32
  33
  34
  35 enum        <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a>;
  36 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-create">gnome_vfs_create</a>             (GnomeVFSHandle **handle,
  37                                              const <a
  38 href="../glib/glib-Basic-Types.html#gchar"
  39 >gchar</a> *text_uri,
  40                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode,
  41                                              <a
  42 href="../glib/glib-Basic-Types.html#gboolean"
  43 >gboolean</a> exclusive,
  44                                              <a
  45 href="../glib/glib-Basic-Types.html#guint"
  46 >guint</a> perm);
  47 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-create-uri">gnome_vfs_create_uri</a>         (GnomeVFSHandle **handle,
  48                                              GnomeVFSURI *uri,
  49                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode,
  50                                              <a
  51 href="../glib/glib-Basic-Types.html#gboolean"
  52 >gboolean</a> exclusive,
  53                                              <a
  54 href="../glib/glib-Basic-Types.html#guint"
  55 >guint</a> perm);
  56 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-open">gnome_vfs_open</a>               (GnomeVFSHandle **handle,
  57                                              const <a
  58 href="../glib/glib-Basic-Types.html#gchar"
  59 >gchar</a> *text_uri,
  60                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode);
  61 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-open-uri">gnome_vfs_open_uri</a>           (GnomeVFSHandle **handle,
  62                                              GnomeVFSURI *uri,
  63                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode);
  64 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-close">gnome_vfs_close</a>              (GnomeVFSHandle *handle);
  65 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-unlink">gnome_vfs_unlink</a>             (const <a
  66 href="../glib/glib-Basic-Types.html#gchar"
  67 >gchar</a> *text_uri);
  68 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-unlink-from-uri">gnome_vfs_unlink_from_uri</a>    (GnomeVFSURI *uri);
  69 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-move-uri">gnome_vfs_move_uri</a>           (GnomeVFSURI *old_uri,
  70                                              GnomeVFSURI *new_uri,
  71                                              <a
  72 href="../glib/glib-Basic-Types.html#gboolean"
  73 >gboolean</a> force_replace);
  74 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-move">gnome_vfs_move</a>               (const <a
  75 href="../glib/glib-Basic-Types.html#gchar"
  76 >gchar</a> *old_text_uri,
  77                                              const <a
  78 href="../glib/glib-Basic-Types.html#gchar"
  79 >gchar</a> *new_text_uri,
  80                                              <a
  81 href="../glib/glib-Basic-Types.html#gboolean"
  82 >gboolean</a> force_replace);
  83 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-check-same-fs-uris">gnome_vfs_check_same_fs_uris</a> (GnomeVFSURI *source_uri,
  84                                              GnomeVFSURI *target_uri,
  85                                              <a
  86 href="../glib/glib-Basic-Types.html#gboolean"
  87 >gboolean</a> *same_fs_return);
  88 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-check-same-fs">gnome_vfs_check_same_fs</a>      (const <a
  89 href="../glib/glib-Basic-Types.html#gchar"
  90 >gchar</a> *source,
  91                                              const <a
  92 href="../glib/glib-Basic-Types.html#gchar"
  93 >gchar</a> *target,
  94                                              <a
  95 href="../glib/glib-Basic-Types.html#gboolean"
  96 >gboolean</a> *same_fs_return);
  97 <a
  98 href="../glib/glib-Basic-Types.html#gboolean"
  99 >gboolean</a>    <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-uri-exists">gnome_vfs_uri_exists</a>            (GnomeVFSURI *uri);
 100 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#gnome-vfs-create-symbolic-link">gnome_vfs_create_symbolic_link</a>
 101                                             (GnomeVFSURI *uri,
 102                                              const <a
 103 href="../glib/glib-Basic-Types.html#gchar"
 104 >gchar</a> *target_reference);
 105 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
 106
 107 </p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="GnomeVFSOpenMode"></a>enum GnomeVFSOpenMode</h3><pre class="programlisting">typedef enum {
 108         GNOME_VFS_OPEN_NONE = 0,
 109         GNOME_VFS_OPEN_READ = 1 &lt;&lt; 0,
 110         GNOME_VFS_OPEN_WRITE = 1 &lt;&lt; 1,
 111         GNOME_VFS_OPEN_RANDOM = 1 &lt;&lt; 2
 112 } GnomeVFSOpenMode;
 113 </pre><p>
 114 Mode in which files are opened. If GNOME_VFS_OPEN_RANDOM is not used, the
 115 file will be have to be accessed sequentially.</p><p>
 116
 117 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-create"></a>gnome_vfs_create ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_create             (GnomeVFSHandle **handle,
 118                                              const <a
 119 href="../glib/glib-Basic-Types.html#gchar"
 120 >gchar</a> *text_uri,
 121                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode,
 122                                              <a
 123 href="../glib/glib-Basic-Types.html#gboolean"
 124 >gboolean</a> exclusive,
 125                                              <a
 126 href="../glib/glib-Basic-Types.html#guint"
 127 >guint</a> perm);</pre><p>
 128 Create <i class="parameter"><tt>uri</tt></i> according to mode <i class="parameter"><tt>open_mode</tt></i>.  On return, <i class="parameter"><tt>handle</tt></i> will then
 129 contain a pointer to a handle for the open file.</p><p>
 130
 131 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>handle</tt></i> :</span></td><td> A pointer to a pointer to a GnomeVFSHandle object
 132 </td></tr><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> String representing the URI to create
 133 </td></tr><tr><td><span class="term"><i class="parameter"><tt>open_mode</tt></i> :</span></td><td> mode to leave the file opened in after creation (or <tt class="literal">GNOME_VFS_OPEN_MODE_NONE</tt>
 134 to leave the file closed after creation)
 135 </td></tr><tr><td><span class="term"><i class="parameter"><tt>exclusive</tt></i> :</span></td><td> Whether the file should be created in &quot;exclusive&quot; mode:
 136 i.e. if this flag is nonzero, operation will fail if a file with the
 137 same name already exists.
 138 </td></tr><tr><td><span class="term"><i class="parameter"><tt>perm</tt></i> :</span></td><td> Bitmap representing the permissions for the newly created file
 139 (Unix style).
 140 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 141 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-create-uri"></a>gnome_vfs_create_uri ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_create_uri         (GnomeVFSHandle **handle,
 142                                              GnomeVFSURI *uri,
 143                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode,
 144                                              <a
 145 href="../glib/glib-Basic-Types.html#gboolean"
 146 >gboolean</a> exclusive,
 147                                              <a
 148 href="../glib/glib-Basic-Types.html#guint"
 149 >guint</a> perm);</pre><p>
 150 Create <i class="parameter"><tt>uri</tt></i> according to mode <i class="parameter"><tt>open_mode</tt></i>.  On return, <i class="parameter"><tt>handle</tt></i> will then
 151 contain a pointer to a handle for the open file.</p><p>
 152
 153 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>handle</tt></i> :</span></td><td> A pointer to a pointer to a GnomeVFSHandle object
 154 </td></tr><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> URI for the file to create
 155 </td></tr><tr><td><span class="term"><i class="parameter"><tt>open_mode</tt></i> :</span></td><td> Open mode
 156 </td></tr><tr><td><span class="term"><i class="parameter"><tt>exclusive</tt></i> :</span></td><td> Whether the file should be created in &quot;exclusive&quot; mode:
 157 i.e. if this flag is nonzero, operation will fail if a file with the
 158 same name already exists.
 159 </td></tr><tr><td><span class="term"><i class="parameter"><tt>perm</tt></i> :</span></td><td> Bitmap representing the permissions for the newly created file
 160 (Unix style).
 161 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 162 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-open"></a>gnome_vfs_open ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_open               (GnomeVFSHandle **handle,
 163                                              const <a
 164 href="../glib/glib-Basic-Types.html#gchar"
 165 >gchar</a> *text_uri,
 166                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode);</pre><p>
 167 Open <i class="parameter"><tt>text_uri</tt></i> according to mode <i class="parameter"><tt>open_mode</tt></i>.  On return, <i class="parameter"><tt>handle</tt></i> will then
 168 contain a pointer to a handle for the open file.</p><p>
 169
 170 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>handle</tt></i> :</span></td><td> A pointer to a pointer to a GnomeVFSHandle object
 171 </td></tr><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> String representing the URI to open
 172 </td></tr><tr><td><span class="term"><i class="parameter"><tt>open_mode</tt></i> :</span></td><td> Open mode
 173 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 174 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-open-uri"></a>gnome_vfs_open_uri ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_open_uri           (GnomeVFSHandle **handle,
 175                                              GnomeVFSURI *uri,
 176                                              <a href="gnome-vfs-gnome-vfs-file-basic-ops.html#GnomeVFSOpenMode">GnomeVFSOpenMode</a> open_mode);</pre><p>
 177 Open <i class="parameter"><tt>uri</tt></i> according to mode <i class="parameter"><tt>open_mode</tt></i>.  On return, <i class="parameter"><tt>handle</tt></i> will then
 178 contain a pointer to a handle for the open file.</p><p>
 179
 180 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>handle</tt></i> :</span></td><td> A pointer to a pointer to a GnomeVFSHandle object
 181 </td></tr><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> URI to open
 182 </td></tr><tr><td><span class="term"><i class="parameter"><tt>open_mode</tt></i> :</span></td><td> Open mode
 183 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 184 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-close"></a>gnome_vfs_close ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_close              (GnomeVFSHandle *handle);</pre><p>
 185 Close file associated with <i class="parameter"><tt>handle</tt></i>.</p><p>
 186
 187 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>handle</tt></i> :</span></td><td> A pointer to a GnomeVFSHandle object
 188 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation.
 189 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-unlink"></a>gnome_vfs_unlink ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_unlink             (const <a
 190 href="../glib/glib-Basic-Types.html#gchar"
 191 >gchar</a> *text_uri);</pre><p>
 192 Unlink <i class="parameter"><tt>text_uri</tt></i> (i.e. delete the file).</p><p>
 193
 194 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> URI of the file to be unlinked
 195 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 196 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-unlink-from-uri"></a>gnome_vfs_unlink_from_uri ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_unlink_from_uri    (GnomeVFSURI *uri);</pre><p>
 197 Unlink <i class="parameter"><tt>uri</tt></i> (i.e. delete the file).</p><p>
 198
 199 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> URI of the file to be unlinked
 200 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 201 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-move-uri"></a>gnome_vfs_move_uri ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_move_uri           (GnomeVFSURI *old_uri,
 202                                              GnomeVFSURI *new_uri,
 203                                              <a
 204 href="../glib/glib-Basic-Types.html#gboolean"
 205 >gboolean</a> force_replace);</pre><p>
 206 Move a file from URI <i class="parameter"><tt>old_uri</tt></i> to <i class="parameter"><tt>new_uri</tt></i>.  This will only work if <i class="parameter"><tt>old_uri</tt></i>
 207 and <i class="parameter"><tt>new_uri</tt></i> are on the same file system.  Otherwise, it is necessary
 208 to use the more general %<a href="gnome-vfs-gnome-vfs-xfer.html#gnome-vfs-xfer-uri">gnome_vfs_xfer_uri</a>() function.</p><p>
 209
 210 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>old_uri</tt></i> :</span></td><td> Source URI
 211 </td></tr><tr><td><span class="term"><i class="parameter"><tt>new_uri</tt></i> :</span></td><td> Destination URI
 212 </td></tr><tr><td><span class="term"><i class="parameter"><tt>force_replace</tt></i> :</span></td><td> If <tt class="literal">TRUE</tt>, move target to <i class="parameter"><tt>new_uri</tt></i> even if there
 213 is already a file at <i class="parameter"><tt>new_uri</tt></i>. If there is a file, it will be discarded.
 214 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation.
 215 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-move"></a>gnome_vfs_move ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_move               (const <a
 216 href="../glib/glib-Basic-Types.html#gchar"
 217 >gchar</a> *old_text_uri,
 218                                              const <a
 219 href="../glib/glib-Basic-Types.html#gchar"
 220 >gchar</a> *new_text_uri,
 221                                              <a
 222 href="../glib/glib-Basic-Types.html#gboolean"
 223 >gboolean</a> force_replace);</pre><p>
 224 Move a file from URI <i class="parameter"><tt>old_text_uri</tt></i> to <i class="parameter"><tt>new_text_uri</tt></i>.  This will only work
 225 if <i class="parameter"><tt>old_text_uri</tt></i> and <i class="parameter"><tt>new_text_uri</tt></i> are on the same file system.  Otherwise,
 226 it is necessary to use the more general %<a href="gnome-vfs-gnome-vfs-xfer.html#gnome-vfs-xfer-uri">gnome_vfs_xfer_uri</a>() function.</p><p>
 227
 228 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>old_text_uri</tt></i> :</span></td><td> Source URI
 229 </td></tr><tr><td><span class="term"><i class="parameter"><tt>new_text_uri</tt></i> :</span></td><td> Destination URI
 230 </td></tr><tr><td><span class="term"><i class="parameter"><tt>force_replace</tt></i> :</span></td><td> if <tt class="literal">TRUE</tt>, perform the operation even if it unlinks an existing
 231 file at <i class="parameter"><tt>new_text_uri</tt></i>
 232 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation.
 233 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-check-same-fs-uris"></a>gnome_vfs_check_same_fs_uris ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_check_same_fs_uris (GnomeVFSURI *source_uri,
 234                                              GnomeVFSURI *target_uri,
 235                                              <a
 236 href="../glib/glib-Basic-Types.html#gboolean"
 237 >gboolean</a> *same_fs_return);</pre><p>
 238 Check if <i class="parameter"><tt>source_uri</tt></i> and <i class="parameter"><tt>target_uri</tt></i> are on the same file system.</p><p>
 239
 240 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>source_uri</tt></i> :</span></td><td> A URI
 241 </td></tr><tr><td><span class="term"><i class="parameter"><tt>target_uri</tt></i> :</span></td><td> Another URI
 242 </td></tr><tr><td><span class="term"><i class="parameter"><tt>same_fs_return</tt></i> :</span></td><td> Pointer to a boolean variable which will be set to <tt class="literal">TRUE</tt>
 243 if <i class="parameter"><tt>source_uri</tt></i> and <i class="parameter"><tt>target_uri</tt></i> are on the same file system on return.
 244 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation.
 245 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-check-same-fs"></a>gnome_vfs_check_same_fs ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_check_same_fs      (const <a
 246 href="../glib/glib-Basic-Types.html#gchar"
 247 >gchar</a> *source,
 248                                              const <a
 249 href="../glib/glib-Basic-Types.html#gchar"
 250 >gchar</a> *target,
 251                                              <a
 252 href="../glib/glib-Basic-Types.html#gboolean"
 253 >gboolean</a> *same_fs_return);</pre><p>
 254 Return <tt class="literal">TRUE</tt> if <i class="parameter"><tt>source</tt></i> and <i class="parameter"><tt>target</tt></i> are on the same file system.</p><p>
 255
 256 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>source</tt></i> :</span></td><td> A URI
 257 </td></tr><tr><td><span class="term"><i class="parameter"><tt>target</tt></i> :</span></td><td> Another URI
 258 </td></tr><tr><td><span class="term"><i class="parameter"><tt>same_fs_return</tt></i> :</span></td><td> Pointer to a boolean variable which will be set to <tt class="literal">TRUE</tt>
 259 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation.
 260 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-uri-exists"></a>gnome_vfs_uri_exists ()</h3><pre class="programlisting"><a
 261 href="../glib/glib-Basic-Types.html#gboolean"
 262 >gboolean</a>    gnome_vfs_uri_exists            (GnomeVFSURI *uri);</pre><p>
 263 Check if the URI points to an existing entity.</p><p>
 264
 265 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> A URI
 266 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if URI exists.
 267 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-create-symbolic-link"></a>gnome_vfs_create_symbolic_link ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_create_symbolic_link
 268                                             (GnomeVFSURI *uri,
 269                                              const <a
 270 href="../glib/glib-Basic-Types.html#gchar"
 271 >gchar</a> *target_reference);</pre><p>
 272 Creates a symbolic link, or eventually, a URI link (as necessary)
 273 at <i class="parameter"><tt>uri</tt></i> pointing to <i class="parameter"><tt>target_reference</tt></i></p><p>
 274
 275 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> URI to create a link at
 276 </td></tr><tr><td><span class="term"><i class="parameter"><tt>target_reference</tt></i> :</span></td><td> URI &quot;reference&quot; to point the link to (URI or relative path)
 277 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer representing the result of the operation
 278 </td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="gnome-vfs-file-operations.html"><b>&lt;&lt; File Handling</b></a></td><td align="right"><a accesskey="n" href="gnome-vfs-gnome-vfs-file-rw-ops.html"><b>Reading and Writing &gt;&gt;</b></a></td></tr></table></body></html>