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

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>
   2 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">
   3         .synopsis, .classsynopsis {
   4             background: #eeeeee;
   5             border: solid 1px #aaaaaa;
   6             padding: 0.5em;
   7         }
   8         .programlisting {
   9             background: #eeeeff;
  10             border: solid 1px #aaaaff;
  11             padding: 0.5em;
  12         }
  13         .variablelist {
  14             padding: 4px;
  15             margin-left: 3em;
  16         }
  17         .navigation {
  18             background: #ffeeee;
  19             border: solid 1px #ffaaaa;
  20             margin-top: 0.5em;
  21             margin-bottom: 0.5em;
  22         }
  23         .navigation a {
  24             color: #770000;
  25         }
  26         .navigation a:visited {
  27             color: #550000;
  28         }
  29         .navigation .title {
  30             font-size: 200%;
  31         }
  32       </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-gnome-vfs-directory-basic-ops.html" title="
  33 Basic Directory Operations"><link rel="next" href="gnome-vfs-gnome-vfs-directory-find-ops.html" title="
  34 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-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-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-gnome-vfs-directory-list-ops"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2><span class="refentrytitle">
  35 Listing Directory Contents</span></h2><p>
  36 Listing Directory Contents &#8212;
  37 Listing the contents of directories.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
  38
  39
  40
  41 enum        <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a>;
  42 <a
  43 href="../glib/glib-Basic-Types.html#gboolean"
  44 >gboolean</a>    (<a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">*GnomeVFSDirectoryVisitFunc</a>)   (const <a
  45 href="../glib/glib-Basic-Types.html#gchar"
  46 >gchar</a> *rel_path,
  47                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info,
  48                                              <a
  49 href="../glib/glib-Basic-Types.html#gboolean"
  50 >gboolean</a> recursing_will_loop,
  51                                              <a
  52 href="../glib/glib-Basic-Types.html#gpointer"
  53 >gpointer</a> data,
  54                                              <a
  55 href="../glib/glib-Basic-Types.html#gboolean"
  56 >gboolean</a> *recurse);
  57 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-open">gnome_vfs_directory_open</a>     (GnomeVFSDirectoryHandle **handle,
  58                                              const <a
  59 href="../glib/glib-Basic-Types.html#gchar"
  60 >gchar</a> *text_uri,
  61                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);
  62 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-open-from-uri">gnome_vfs_directory_open_from_uri</a>
  63                                             (GnomeVFSDirectoryHandle **handle,
  64                                              GnomeVFSURI *uri,
  65                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);
  66 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-read-next">gnome_vfs_directory_read_next</a>
  67                                             (GnomeVFSDirectoryHandle *handle,
  68                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *file_info);
  69 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-close">gnome_vfs_directory_close</a>    (GnomeVFSDirectoryHandle *handle);
  70 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit">gnome_vfs_directory_visit</a>    (const <a
  71 href="../glib/glib-Basic-Types.html#gchar"
  72 >gchar</a> *uri,
  73                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
  74                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
  75                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
  76                                              <a
  77 href="../glib/glib-Basic-Types.html#gpointer"
  78 >gpointer</a> data);
  79 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit-uri">gnome_vfs_directory_visit_uri</a>
  80                                             (GnomeVFSURI *uri,
  81                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
  82                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
  83                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
  84                                              <a
  85 href="../glib/glib-Basic-Types.html#gpointer"
  86 >gpointer</a> data);
  87 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit-files">gnome_vfs_directory_visit_files</a>
  88                                             (const <a
  89 href="../glib/glib-Basic-Types.html#gchar"
  90 >gchar</a> *text_uri,
  91                                              <a
  92 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  93 >GList</a> *file_list,
  94                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
  95                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
  96                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
  97                                              <a
  98 href="../glib/glib-Basic-Types.html#gpointer"
  99 >gpointer</a> data);
 100 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-visit-files-at-uri">gnome_vfs_directory_visit_files_at_uri</a>
 101                                             (GnomeVFSURI *uri,
 102                                              <a
 103 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 104 >GList</a> *file_list,
 105                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 106                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 107                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 108                                              <a
 109 href="../glib/glib-Basic-Types.html#gpointer"
 110 >gpointer</a> data);
 111 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#gnome-vfs-directory-list-load">gnome_vfs_directory_list_load</a>
 112                                             (<a
 113 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 114 >GList</a> **list,
 115                                              const <a
 116 href="../glib/glib-Basic-Types.html#gchar"
 117 >gchar</a> *text_uri,
 118                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);
 119 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
 120
 121 </p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="GnomeVFSDirectoryVisitOptions"></a>enum GnomeVFSDirectoryVisitOptions</h3><pre class="programlisting">typedef enum {
 122         GNOME_VFS_DIRECTORY_VISIT_DEFAULT = 0,
 123         GNOME_VFS_DIRECTORY_VISIT_SAMEFS = 1 &lt;&lt; 0,
 124         GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK = 1 &lt;&lt; 1
 125 } GnomeVFSDirectoryVisitOptions;
 126 </pre><p>
 127 This options control the way in which directories are visited.</p><p>
 128
 129 </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>
 130 </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
 131 file system as the parent
 132 </td></tr><tr><td><span class="term"><tt class="literal">GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK</tt></span></td><td> Loop prevention
 133 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="GnomeVFSDirectoryVisitFunc"></a>GnomeVFSDirectoryVisitFunc ()</h3><pre class="programlisting"><a
 134 href="../glib/glib-Basic-Types.html#gboolean"
 135 >gboolean</a>    (*GnomeVFSDirectoryVisitFunc)   (const <a
 136 href="../glib/glib-Basic-Types.html#gchar"
 137 >gchar</a> *rel_path,
 138                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info,
 139                                              <a
 140 href="../glib/glib-Basic-Types.html#gboolean"
 141 >gboolean</a> recursing_will_loop,
 142                                              <a
 143 href="../glib/glib-Basic-Types.html#gpointer"
 144 >gpointer</a> data,
 145                                              <a
 146 href="../glib/glib-Basic-Types.html#gboolean"
 147 >gboolean</a> *recurse);</pre><p>
 148
 149 </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>
 150 </td></tr><tr><td><span class="term"><i class="parameter"><tt>info</tt></i> :</span></td><td>
 151 </td></tr><tr><td><span class="term"><i class="parameter"><tt>recursing_will_loop</tt></i> :</span></td><td>
 152 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td>
 153 </td></tr><tr><td><span class="term"><i class="parameter"><tt>recurse</tt></i> :</span></td><td>
 154 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
 155
 156
 157 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_open     (GnomeVFSDirectoryHandle **handle,
 158                                              const <a
 159 href="../glib/glib-Basic-Types.html#gchar"
 160 >gchar</a> *text_uri,
 161                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);</pre><p>
 162 Open directory <i class="parameter"><tt>text_uri</tt></i> for reading.  On return, @*handle will point to
 163 a <tt class="literal">GnomeVFSDirectoryHandle</tt> object which can be used to read the directory
 164 entries one by one.</p><p>
 165
 166 </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
 167 </td></tr><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> String representing the URI to open
 168 </td></tr><tr><td><span class="term"><i class="parameter"><tt>options</tt></i> :</span></td><td> Options for reading file information
 169 </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
 170 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_open_from_uri
 171                                             (GnomeVFSDirectoryHandle **handle,
 172                                              GnomeVFSURI *uri,
 173                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);</pre><p>
 174 Open directory <i class="parameter"><tt>text_uri</tt></i> for reading.  On return, @*handle will point to
 175 a <tt class="literal">GnomeVFSDirectoryHandle</tt> object which can be used to read the directory
 176 entries one by one.</p><p>
 177
 178 </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
 179 </td></tr><tr><td><span class="term"><i class="parameter"><tt>uri</tt></i> :</span></td><td> URI to open
 180 </td></tr><tr><td><span class="term"><i class="parameter"><tt>options</tt></i> :</span></td><td> Options for reading file information
 181 </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.
 182 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_read_next
 183                                             (GnomeVFSDirectoryHandle *handle,
 184                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfo">GnomeVFSFileInfo</a> *file_info);</pre><p>
 185 Read the next directory entry from <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 directory handle
 188 </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
 189 the entry will be stored
 190 </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.
 191 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_close    (GnomeVFSDirectoryHandle *handle);</pre><p>
 192 Close <i class="parameter"><tt>handle</tt></i>.</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>handle</tt></i> :</span></td><td> A directory handle.
 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-directory-visit"></a>gnome_vfs_directory_visit ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit    (const <a
 197 href="../glib/glib-Basic-Types.html#gchar"
 198 >gchar</a> *uri,
 199                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 200                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 201                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 202                                              <a
 203 href="../glib/glib-Basic-Types.html#gpointer"
 204 >gpointer</a> data);</pre><p>
 205 Visit <i class="parameter"><tt>uri</tt></i>, retrieving information as specified by <i class="parameter"><tt>info_options</tt></i>.</p><p>
 206
 207 </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
 208 </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
 209 retrieved
 210 </td></tr><tr><td><span class="term"><i class="parameter"><tt>visit_options</tt></i> :</span></td><td> Options specifying the type of visit
 211 </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
 212 </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
 213 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
 214 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit_uri
 215                                             (GnomeVFSURI *uri,
 216                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 217                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 218                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 219                                              <a
 220 href="../glib/glib-Basic-Types.html#gpointer"
 221 >gpointer</a> data);</pre><p>
 222 Visit <i class="parameter"><tt>uri</tt></i>, retrieving information as specified by <i class="parameter"><tt>info_options</tt></i>.</p><p>
 223
 224 </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
 225 </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
 226 retrieved
 227 </td></tr><tr><td><span class="term"><i class="parameter"><tt>visit_options</tt></i> :</span></td><td> Options specifying the type of visit
 228 </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
 229 </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
 230 </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.
 231
 232 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit_files
 233                                             (const <a
 234 href="../glib/glib-Basic-Types.html#gchar"
 235 >gchar</a> *text_uri,
 236                                              <a
 237 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 238 >GList</a> *file_list,
 239                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 240                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 241                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 242                                              <a
 243 href="../glib/glib-Basic-Types.html#gpointer"
 244 >gpointer</a> data);</pre><p>
 245 Fetches information about a list of files in a base URI <i class="parameter"><tt>uri</tt></i>.</p><p>
 246
 247 </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 &quot;visit&quot; the files in
 248 </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
 249 </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
 250 </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.
 251 Affects the way visiting is done.
 252 </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
 253 </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>.
 254 </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
 255 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_visit_files_at_uri
 256                                             (GnomeVFSURI *uri,
 257                                              <a
 258 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 259 >GList</a> *file_list,
 260                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> info_options,
 261                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</a> visit_options,
 262                                              <a href="gnome-vfs-gnome-vfs-directory-list-ops.html#GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</a> callback,
 263                                              <a
 264 href="../glib/glib-Basic-Types.html#gpointer"
 265 >gpointer</a> data);</pre><p>
 266 Fetches information about a list of files in a base URI <i class="parameter"><tt>uri</tt></i>.</p><p>
 267
 268 </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 &quot;visit&quot; the files in
 269 </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
 270 </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
 271 </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.
 272 Affects the way visiting is done.
 273 </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
 274 </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>.
 275 </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
 276 </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><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_directory_list_load
 277                                             (<a
 278 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 279 >GList</a> **list,
 280                                              const <a
 281 href="../glib/glib-Basic-Types.html#gchar"
 282 >gchar</a> *text_uri,
 283                                              <a href="gnome-vfs-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a> options);</pre><p>
 284 Load a directory from <i class="parameter"><tt>text_uri</tt></i> with the specified <i class="parameter"><tt>options</tt></i>
 285 into a list.</p><p>
 286
 287 </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
 288 </td></tr><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> A text URI
 289 </td></tr><tr><td><span class="term"><i class="parameter"><tt>options</tt></i> :</span></td><td> Options for loading the directory
 290 </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.
 291 </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-gnome-vfs-directory-basic-ops.html"><b>&lt;&lt;
 292 Basic Directory Operations</b></a></td><td align="right"><a accesskey="n" href="gnome-vfs-gnome-vfs-directory-find-ops.html"><b>
 293 Locating Standard Directories &gt;&gt;</b></a></td></tr></table></body></html>