doc/html/gnome-vfs-20-gnome-vfs-directory-list-ops.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Listing Directory Contents</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-directory-operations.html" title="Directory Handling"><link rel="previous" href="gnome-vfs-20-gnome-vfs-directory-basic-ops.html" title="Basic Directory Operations"><link rel="next" href="gnome-vfs-20-gnome-vfs-directory-find-ops.html" title="Locating Standard Directories"></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-20-gnome-vfs-directory-basic-ops.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="gnome-vfs-directory-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-20-gnome-vfs-directory-find-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-20-gnome-vfs-directory-list-ops"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2><span class="refentrytitle">Listing Directory Contents</span></h2><p>Listing Directory Contents &#8212;
  32 Listing the contents of directories.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
  33
  34
  35
  36 enum        <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a>;
  37 <a
  38 href="../glib/glib-Basic-Types.html#gboolean"
  39 >gboolean</a>    (<a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">*GnomeVFSDirectoryVisitFunc</a>)   (const <a
  40 href="../glib/glib-Basic-Types.html#gchar"
  41 >gchar</a> *rel_path,
  42                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info,
  43                                              <a
  44 href="../glib/glib-Basic-Types.html#gboolean"
  45 >gboolean</a> recursing_will_loop,
  46                                              <a
  47 href="../glib/glib-Basic-Types.html#gpointer"
  48 >gpointer</a> data,
  49                                              <a
  50 href="../glib/glib-Basic-Types.html#gboolean"
  51 >gboolean</a> *recurse);
  52 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-open">gnome_vfs_directory_open</a>     (GnomeVFSDirectoryHandle **handle,
  53                                              const <a
  54 href="../glib/glib-Basic-Types.html#gchar"
  55 >gchar</a> *text_uri,
  56                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);
  57 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-open-from-uri">gnome_vfs_directory_open_from_uri</a>
  58                                             (GnomeVFSDirectoryHandle **handle,
  59                                              GnomeVFSURI *uri,
  60                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);
  61 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-read-next">gnome_vfs_directory_read_next</a>
  62                                             (GnomeVFSDirectoryHandle *handle,
  63                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *file_info);
  64 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-close">gnome_vfs_directory_close</a>    (GnomeVFSDirectoryHandle *handle);
  65 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit">gnome_vfs_directory_visit</a>    (const <a
  66 href="../glib/glib-Basic-Types.html#gchar"
  67 >gchar</a> *uri,
  68                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
  69                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
  70                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
  71                                              <a
  72 href="../glib/glib-Basic-Types.html#gpointer"
  73 >gpointer</a> data);
  74 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit-uri">gnome_vfs_directory_visit_uri</a>
  75                                             (GnomeVFSURI *uri,
  76                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
  77                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
  78                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
  79                                              <a
  80 href="../glib/glib-Basic-Types.html#gpointer"
  81 >gpointer</a> data);
  82 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit-files">gnome_vfs_directory_visit_files</a>
  83                                             (const <a
  84 href="../glib/glib-Basic-Types.html#gchar"
  85 >gchar</a> *text_uri,
  86                                              <a
  87 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  88 >GList</a> *file_list,
  89                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
  90                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
  91                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
  92                                              <a
  93 href="../glib/glib-Basic-Types.html#gpointer"
  94 >gpointer</a> data);
  95 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit-files-at-uri">gnome_vfs_directory_visit_files_at_uri</a>
  96                                             (GnomeVFSURI *uri,
  97                                              <a
  98 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  99 >GList</a> *file_list,
 100                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 101                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 102                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 103                                              <a
 104 href="../glib/glib-Basic-Types.html#gpointer"
 105 >gpointer</a> data);
 106 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-list-load">gnome_vfs_directory_list_load</a>
 107                                             (<a
 108 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 109 >GList</a> **list,
 110                                              const <a
 111 href="../glib/glib-Basic-Types.html#gchar"
 112 >gchar</a> *text_uri,
 113                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);
 114 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
 115
 116 </p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="GnomeVFSDirectoryVisitOptions"></a>enum GnomeVFSDirectoryVisitOptions</h3><a class="indexterm" name="id2886844"></a><pre class="programlisting">typedef enum {
 117         GNOME_VFS_DIRECTORY_VISIT_DEFAULT = 0,
 118         GNOME_VFS_DIRECTORY_VISIT_SAMEFS = 1 &lt;&lt; 0,
 119         GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK = 1 &lt;&lt; 1
 120 } GnomeVFSDirectoryVisitOptions;
 121 </pre><p>
 122 This options control the way in which directories are visited.</p><p>
 123
 124 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><tt class="literal">GNOME_VFS_DIRECTORY_VISIT_DEFAULT</tt></span></td><td>
 125 </td></tr><tr><td><span class="term"><tt class="literal">GNOME_VFS_DIRECTORY_VISIT_SAMEFS</tt></span></td><td> Visit only directories on the same
 126 file system as the parent
 127 </td></tr><tr><td><span class="term"><tt class="literal">GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK</tt></span></td><td> Loop prevention
 128 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="GnomeVFSDirectoryVisitFunc"></a>GnomeVFSDirectoryVisitFunc ()</h3><a class="indexterm" name="id2886947"></a><pre class="programlisting"><a
 129 href="../glib/glib-Basic-Types.html#gboolean"
 130 >gboolean</a>    (*GnomeVFSDirectoryVisitFunc)   (const <a
 131 href="../glib/glib-Basic-Types.html#gchar"
 132 >gchar</a> *rel_path,
 133                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info,
 134                                              <a
 135 href="../glib/glib-Basic-Types.html#gboolean"
 136 >gboolean</a> recursing_will_loop,
 137                                              <a
 138 href="../glib/glib-Basic-Types.html#gpointer"
 139 >gpointer</a> data,
 140                                              <a
 141 href="../glib/glib-Basic-Types.html#gboolean"
 142 >gboolean</a> *recurse);</pre><p>
 143
 144 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>rel_path</tt></i> :</span></td><td>
 145 </td></tr><tr><td><span class="term"><i class="parameter"><tt>info</tt></i> :</span></td><td>
 146 </td></tr><tr><td><span class="term"><i class="parameter"><tt>recursing_will_loop</tt></i> :</span></td><td>
 147 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td>
 148 </td></tr><tr><td><span class="term"><i class="parameter"><tt>recurse</tt></i> :</span></td><td>
 149 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
 150
 151
 152 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-open"></a>gnome_vfs_directory_open ()</h3><a class="indexterm" name="id2887128"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_open     (GnomeVFSDirectoryHandle **handle,
 153                                              const <a
 154 href="../glib/glib-Basic-Types.html#gchar"
 155 >gchar</a> *text_uri,
 156                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);</pre><p>
 157 Open directory <i class="parameter"><tt>text_uri</tt></i> for reading.  On return, @*handle will point to
 158 a <tt class="literal">GnomeVFSDirectoryHandle</tt> object which can be used to read the directory
 159 entries one by one.</p><p>
 160
 161 </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 GnomeVFSDirectoryHandle object
 162 </td></tr><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> String representing the URI to open
 163 </td></tr><tr><td><span class="term"><i class="parameter"><tt>options</tt></i> :</span></td><td> Options for reading file information
 164 </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
 165 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-open-from-uri"></a>gnome_vfs_directory_open_from_uri ()</h3><a class="indexterm" name="id2887289"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_open_from_uri
 166                                             (GnomeVFSDirectoryHandle **handle,
 167                                              GnomeVFSURI *uri,
 168                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);</pre><p>
 169 Open directory <i class="parameter"><tt>text_uri</tt></i> for reading.  On return, @*handle will point to
 170 a <tt class="literal">GnomeVFSDirectoryHandle</tt> object which can be used to read the directory
 171 entries one by one.</p><p>
 172
 173 </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 GnomeVFSDirectoryHandle object
 174 </td></tr><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> URI to open
 175 </td></tr><tr><td><span class="term"><i class="parameter"><tt>options</tt></i> :</span></td><td> Options for reading file information
 176 </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.
 177 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-read-next"></a>gnome_vfs_directory_read_next ()</h3><a class="indexterm" name="id2887448"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_read_next
 178                                             (GnomeVFSDirectoryHandle *handle,
 179                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *file_info);</pre><p>
 180 Read the next directory entry from <i class="parameter"><tt>handle</tt></i>.</p><p>
 181
 182 </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 directory handle
 183 </td></tr><tr><td><span class="term"><i class="parameter"><tt>file_info</tt></i> :</span></td><td> Pointer to a <tt class="literal">GnomeVFSFileInfo</tt> struct where the data about
 184 the entry will be stored
 185 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An integer value representing the result of the operation.
 186 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-close"></a>gnome_vfs_directory_close ()</h3><a class="indexterm" name="id2887579"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_close    (GnomeVFSDirectoryHandle *handle);</pre><p>
 187 Close <i class="parameter"><tt>handle</tt></i>.</p><p>
 188
 189 </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 directory handle.
 190 </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.
 191 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-visit"></a>gnome_vfs_directory_visit ()</h3><a class="indexterm" name="id2887674"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit    (const <a
 192 href="../glib/glib-Basic-Types.html#gchar"
 193 >gchar</a> *uri,
 194                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 195                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 196                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 197                                              <a
 198 href="../glib/glib-Basic-Types.html#gpointer"
 199 >gpointer</a> data);</pre><p>
 200 Visit <i class="parameter"><tt>uri</tt></i>, retrieving information as specified by <i class="parameter"><tt>info_options</tt></i>.</p><p>
 201
 202 </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 start from
 203 </td></tr><tr><td><span class="term"><i class="parameter"><tt>info_options</tt></i> :</span></td><td> Options specifying what kind of file information must be
 204 retrieved
 205 </td></tr><tr><td><span class="term"><i class="parameter"><tt>visit_options</tt></i> :</span></td><td> Options specifying the type of visit
 206 </td></tr><tr><td><span class="term"><i class="parameter"><tt>callback</tt></i> :</span></td><td> Callback to be called for every visited file
 207 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td> Data to be passed to <i class="parameter"><tt>callback</tt></i> at each iteration
 208 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
 209 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-visit-uri"></a>gnome_vfs_directory_visit_uri ()</h3><a class="indexterm" name="id2887890"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit_uri
 210                                             (GnomeVFSURI *uri,
 211                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 212                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 213                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 214                                              <a
 215 href="../glib/glib-Basic-Types.html#gpointer"
 216 >gpointer</a> data);</pre><p>
 217 Visit <i class="parameter"><tt>uri</tt></i>, retrieving information as specified by <i class="parameter"><tt>info_options</tt></i>.</p><p>
 218
 219 </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 start from
 220 </td></tr><tr><td><span class="term"><i class="parameter"><tt>info_options</tt></i> :</span></td><td> Options specifying what kind of file information must be
 221 retrieved
 222 </td></tr><tr><td><span class="term"><i class="parameter"><tt>visit_options</tt></i> :</span></td><td> Options specifying the type of visit
 223 </td></tr><tr><td><span class="term"><i class="parameter"><tt>callback</tt></i> :</span></td><td> Callback to be called for every visited file
 224 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td> Data to be passed to <i class="parameter"><tt>callback</tt></i> at each iteration
 225 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A result code indicating whether the operation succeeded.
 226
 227 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-visit-files"></a>gnome_vfs_directory_visit_files ()</h3><a class="indexterm" name="id2888108"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit_files
 228                                             (const <a
 229 href="../glib/glib-Basic-Types.html#gchar"
 230 >gchar</a> *text_uri,
 231                                              <a
 232 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 233 >GList</a> *file_list,
 234                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 235                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 236                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 237                                              <a
 238 href="../glib/glib-Basic-Types.html#gpointer"
 239 >gpointer</a> data);</pre><p>
 240 Fetches information about a list of files in a base URI <i class="parameter"><tt>uri</tt></i>.</p><p>
 241
 242 </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> string representing the URI of a directory to "visit" the files in
 243 </td></tr><tr><td><span class="term"><i class="parameter"><tt>file_list</tt></i> :</span></td><td> GList of char *s of file names in <i class="parameter"><tt>uri</tt></i> to visit
 244 </td></tr><tr><td><span class="term"><i class="parameter"><tt>info_options</tt></i> :</span></td><td> bitmask controlling the type of information to fetch
 245 </td></tr><tr><td><span class="term"><i class="parameter"><tt>visit_options</tt></i> :</span></td><td> options controlling e.g. loop prevention, and filesystem checks.
 246 Affects the way visiting is done.
 247 </td></tr><tr><td><span class="term"><i class="parameter"><tt>callback</tt></i> :</span></td><td> function to call with the file info structs
 248 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td> data to pass to <i class="parameter"><tt>callback</tt></i>.
 249 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a GnomeVFSResult indication the success of the operation
 250 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-visit-files-at-uri"></a>gnome_vfs_directory_visit_files_at_uri ()</h3><a class="indexterm" name="id2888355"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit_files_at_uri
 251                                             (GnomeVFSURI *uri,
 252                                              <a
 253 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 254 >GList</a> *file_list,
 255                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 256                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 257                                              <a href="gnome-vfs-20-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 258                                              <a
 259 href="../glib/glib-Basic-Types.html#gpointer"
 260 >gpointer</a> data);</pre><p>
 261 Fetches information about a list of files in a base URI <i class="parameter"><tt>uri</tt></i>.</p><p>
 262
 263 </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 a directory to "visit" the files in
 264 </td></tr><tr><td><span class="term"><i class="parameter"><tt>file_list</tt></i> :</span></td><td> GList of char *s of file names in <i class="parameter"><tt>uri</tt></i> to visit
 265 </td></tr><tr><td><span class="term"><i class="parameter"><tt>info_options</tt></i> :</span></td><td> bitmask controlling the type of information to fetch
 266 </td></tr><tr><td><span class="term"><i class="parameter"><tt>visit_options</tt></i> :</span></td><td> options controlling e.g. loop prevention, and filesystem checks.
 267 Affects the way visiting is done.
 268 </td></tr><tr><td><span class="term"><i class="parameter"><tt>callback</tt></i> :</span></td><td> function to call with the file info structs
 269 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td> data to pass to <i class="parameter"><tt>callback</tt></i>.
 270 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a GnomeVFSResult indication the success of the operation
 271 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-directory-list-load"></a>gnome_vfs_directory_list_load ()</h3><a class="indexterm" name="id2888601"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_list_load
 272                                             (<a
 273 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 274 >GList</a> **list,
 275                                              const <a
 276 href="../glib/glib-Basic-Types.html#gchar"
 277 >gchar</a> *text_uri,
 278                                              <a href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);</pre><p>
 279 Load a directory from <i class="parameter"><tt>text_uri</tt></i> with the specified <i class="parameter"><tt>options</tt></i>
 280 into a list.</p><p>
 281
 282 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>list</tt></i> :</span></td><td> An address of a pointer to a list of GnomeVFSFileInfo
 283 </td></tr><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> A text URI
 284 </td></tr><tr><td><span class="term"><i class="parameter"><tt>options</tt></i> :</span></td><td> Options for loading the directory
 285 </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.
 286 </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-20-gnome-vfs-directory-basic-ops.html"><b>&lt;&lt; Basic Directory Operations</b></a></td><td align="right"><a accesskey="n" href="gnome-vfs-20-gnome-vfs-directory-find-ops.html"><b>Locating Standard Directories &gt;&gt;</b></a></td></tr></table></body></html>