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

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Directory Operations</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
   8 "><LINK
   9 REL="HOME"
  10 TITLE="GnomeVFS - Filesystem Abstraction library"
  11 HREF="index.html"><LINK
  12 REL="UP"
  13 TITLE="Directories"
  14 HREF="directory-operations.html"><LINK
  15 REL="PREVIOUS"
  16 TITLE="Directories"
  17 HREF="directory-operations.html"><LINK
  18 REL="NEXT"
  19 TITLE="Locating Standard Directories"
  20 HREF="gnome-vfs-gnome-vfs-find-directory.html"><META
  21 NAME="GENERATOR"
  22 CONTENT="GTK-Doc V0.10 (SGML mode)"><STYLE
  23 TYPE="text/css"
  24 >.synopsis, .classsynopsis {
  25     background: #eeeeee;
  26     border: solid 1px #aaaaaa;
  27     padding: 0.5em;
  28 }
  29 .programlisting {
  30     background: #eeeeff;
  31     border: solid 1px #aaaaff;
  32     padding: 0.5em;
  33 }
  34 .variablelist {
  35     padding: 4px;
  36     margin-left: 3em;
  37 }
  38 .navigation {
  39     background: #ffeeee;
  40     border: solid 1px #ffaaaa;
  41     margin-top: 0.5em;
  42     margin-bottom: 0.5em;
  43 }
  44 .navigation a {
  45     color: #770000;
  46 }
  47 .navigation a:visited {
  48     color: #550000;
  49 }
  50 .navigation .title {
  51     font-size: 200%;
  52 }</STYLE
  53 ></HEAD
  54 ><BODY
  55 CLASS="REFENTRY"
  56 BGCOLOR="#FFFFFF"
  57 TEXT="#000000"
  58 LINK="#0000FF"
  59 VLINK="#840084"
  60 ALINK="#0000FF"
  61 ><TABLE
  62 WIDTH="100%"
  63 CLASS="navigation"
  64 SUMMARY="Navigation header"
  65 CELLPADDING="2"
  66 CELLSPACING="2"
  67 ><TR
  68 VALIGN="middle"
  69 ><TD
  70 ><A
  71 ACCESSKEY="p"
  72 HREF="directory-operations.html"
  73 ><IMG
  74 SRC="left.png"
  75 WIDTH="24"
  76 HEIGHT="24"
  77 BORDER="0"
  78 ALT="Prev"></A
  79 ></TD
  80 ><TD
  81 ><A
  82 ACCESSKEY="u"
  83 HREF="directory-operations.html"
  84 ><IMG
  85 SRC="up.png"
  86 WIDTH="24"
  87 HEIGHT="24"
  88 BORDER="0"
  89 ALT="Up"></A
  90 ></TD
  91 ><TD
  92 ><A
  93 ACCESSKEY="h"
  94 HREF="index.html"
  95 ><IMG
  96 SRC="home.png"
  97 WIDTH="24"
  98 HEIGHT="24"
  99 BORDER="0"
 100 ALT="Home"></A
 101 ></TD
 102 ><TH
 103 WIDTH="100%"
 104 align="center"
 105 >GnomeVFS - Filesystem Abstraction library</TH
 106 ><TD
 107 ><A
 108 ACCESSKEY="n"
 109 HREF="gnome-vfs-gnome-vfs-find-directory.html"
 110 ><IMG
 111 SRC="right.png"
 112 WIDTH="24"
 113 HEIGHT="24"
 114 BORDER="0"
 115 ALT="Next"></A
 116 ></TD
 117 ></TR
 118 ></TABLE
 119 ><H1
 120 ><A
 121 NAME="GNOME-VFS-GNOME-VFS-DIRECTORY"
 122 ></A
 123 >Directory Operations</H1
 124 ><DIV
 125 CLASS="REFNAMEDIV"
 126 ><A
 127 NAME="AEN2523"
 128 ></A
 129 ><H2
 130 >Name</H2
 131 >Directory Operations&nbsp;--&nbsp;reading the contents of directories</DIV
 132 ><DIV
 133 CLASS="REFSYNOPSISDIV"
 134 ><A
 135 NAME="AEN2526"
 136 ></A
 137 ><H2
 138 >Synopsis</H2
 139 ><PRE
 140 CLASS="SYNOPSIS"
 141 >&#13;
 142
 143 enum        <A
 144 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
 145 >GnomeVFSDirectoryVisitOptions</A
 146 >;
 147 gboolean    (<A
 148 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
 149 >*GnomeVFSDirectoryVisitFunc</A
 150 >)   (const gchar *rel_path,
 151                                              <A
 152 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 153 >GnomeVFSFileInfo</A
 154 > *info,
 155                                              gboolean recursing_will_loop,
 156                                              gpointer data,
 157                                              gboolean *recurse);
 158 <A
 159 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 160 >GnomeVFSResult</A
 161 > <A
 162 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-OPEN"
 163 >gnome_vfs_directory_open</A
 164 >     (GnomeVFSDirectoryHandle **handle,
 165                                              const gchar *text_uri,
 166                                              <A
 167 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 168 >GnomeVFSFileInfoOptions</A
 169 > options);
 170 <A
 171 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 172 >GnomeVFSResult</A
 173 > <A
 174 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-OPEN-FROM-URI"
 175 >gnome_vfs_directory_open_from_uri</A
 176 >
 177                                             (GnomeVFSDirectoryHandle **handle,
 178                                              GnomeVFSURI *uri,
 179                                              <A
 180 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 181 >GnomeVFSFileInfoOptions</A
 182 > options);
 183 <A
 184 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 185 >GnomeVFSResult</A
 186 > <A
 187 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-READ-NEXT"
 188 >gnome_vfs_directory_read_next</A
 189 >
 190                                             (GnomeVFSDirectoryHandle *handle,
 191                                              <A
 192 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 193 >GnomeVFSFileInfo</A
 194 > *file_info);
 195 <A
 196 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 197 >GnomeVFSResult</A
 198 > <A
 199 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-CLOSE"
 200 >gnome_vfs_directory_close</A
 201 >    (GnomeVFSDirectoryHandle *handle);
 202 <A
 203 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 204 >GnomeVFSResult</A
 205 > <A
 206 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-VISIT"
 207 >gnome_vfs_directory_visit</A
 208 >    (const gchar *uri,
 209                                              <A
 210 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 211 >GnomeVFSFileInfoOptions</A
 212 > info_options,
 213                                              <A
 214 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
 215 >GnomeVFSDirectoryVisitOptions</A
 216 > visit_options,
 217                                              <A
 218 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
 219 >GnomeVFSDirectoryVisitFunc</A
 220 > callback,
 221                                              gpointer data);
 222 <A
 223 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 224 >GnomeVFSResult</A
 225 > <A
 226 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-VISIT-URI"
 227 >gnome_vfs_directory_visit_uri</A
 228 >
 229                                             (GnomeVFSURI *uri,
 230                                              <A
 231 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 232 >GnomeVFSFileInfoOptions</A
 233 > info_options,
 234                                              <A
 235 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
 236 >GnomeVFSDirectoryVisitOptions</A
 237 > visit_options,
 238                                              <A
 239 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
 240 >GnomeVFSDirectoryVisitFunc</A
 241 > callback,
 242                                              gpointer data);
 243 <A
 244 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 245 >GnomeVFSResult</A
 246 > <A
 247 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-VISIT-FILES"
 248 >gnome_vfs_directory_visit_files</A
 249 >
 250                                             (const gchar *text_uri,
 251                                              GList *file_list,
 252                                              <A
 253 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 254 >GnomeVFSFileInfoOptions</A
 255 > info_options,
 256                                              <A
 257 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
 258 >GnomeVFSDirectoryVisitOptions</A
 259 > visit_options,
 260                                              <A
 261 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
 262 >GnomeVFSDirectoryVisitFunc</A
 263 > callback,
 264                                              gpointer data);
 265 <A
 266 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 267 >GnomeVFSResult</A
 268 > <A
 269 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-VISIT-FILES-AT-URI"
 270 >gnome_vfs_directory_visit_files_at_uri</A
 271 >
 272                                             (GnomeVFSURI *uri,
 273                                              GList *file_list,
 274                                              <A
 275 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 276 >GnomeVFSFileInfoOptions</A
 277 > info_options,
 278                                              <A
 279 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
 280 >GnomeVFSDirectoryVisitOptions</A
 281 > visit_options,
 282                                              <A
 283 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
 284 >GnomeVFSDirectoryVisitFunc</A
 285 > callback,
 286                                              gpointer data);
 287 <A
 288 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 289 >GnomeVFSResult</A
 290 > <A
 291 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-DIRECTORY-LIST-LOAD"
 292 >gnome_vfs_directory_list_load</A
 293 >
 294                                             (GList **list,
 295                                              const gchar *text_uri,
 296                                              <A
 297 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 298 >GnomeVFSFileInfoOptions</A
 299 > options);
 300 <A
 301 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 302 >GnomeVFSResult</A
 303 > <A
 304 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-MAKE-DIRECTORY-FOR-URI"
 305 >gnome_vfs_make_directory_for_uri</A
 306 >
 307                                             (GnomeVFSURI *uri,
 308                                              guint perm);
 309 <A
 310 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 311 >GnomeVFSResult</A
 312 > <A
 313 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-MAKE-DIRECTORY"
 314 >gnome_vfs_make_directory</A
 315 >     (const gchar *text_uri,
 316                                              guint perm);
 317 <A
 318 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 319 >GnomeVFSResult</A
 320 > <A
 321 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-REMOVE-DIRECTORY-FROM-URI"
 322 >gnome_vfs_remove_directory_from_uri</A
 323 >
 324                                             (GnomeVFSURI *uri);
 325 <A
 326 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 327 >GnomeVFSResult</A
 328 > <A
 329 HREF="gnome-vfs-gnome-vfs-directory.html#GNOME-VFS-REMOVE-DIRECTORY"
 330 >gnome_vfs_remove_directory</A
 331 >   (const gchar *text_uri);</PRE
 332 ></DIV
 333 ><DIV
 334 CLASS="REFSECT1"
 335 ><A
 336 NAME="AEN2603"
 337 ></A
 338 ><H2
 339 >Description</H2
 340 ><P
 341 ></P
 342 ></DIV
 343 ><DIV
 344 CLASS="REFSECT1"
 345 ><A
 346 NAME="AEN2606"
 347 ></A
 348 ><H2
 349 >Details</H2
 350 ><DIV
 351 CLASS="REFSECT2"
 352 ><A
 353 NAME="AEN2608"
 354 ></A
 355 ><H3
 356 ><A
 357 NAME="GNOMEVFSDIRECTORYVISITOPTIONS"
 358 ></A
 359 >enum GnomeVFSDirectoryVisitOptions</H3
 360 ><PRE
 361 CLASS="PROGRAMLISTING"
 362 >typedef enum {
 363         GNOME_VFS_DIRECTORY_VISIT_DEFAULT = 0,
 364         GNOME_VFS_DIRECTORY_VISIT_SAMEFS = 1 &lt;&lt; 0,
 365         GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK = 1 &lt;&lt; 1
 366 } GnomeVFSDirectoryVisitOptions;</PRE
 367 ><P
 368 ></P
 369 ></DIV
 370 ><HR><DIV
 371 CLASS="REFSECT2"
 372 ><A
 373 NAME="AEN2613"
 374 ></A
 375 ><H3
 376 ><A
 377 NAME="GNOMEVFSDIRECTORYVISITFUNC"
 378 ></A
 379 >GnomeVFSDirectoryVisitFunc ()</H3
 380 ><PRE
 381 CLASS="PROGRAMLISTING"
 382 >gboolean    (*GnomeVFSDirectoryVisitFunc)   (const gchar *rel_path,
 383                                              <A
 384 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 385 >GnomeVFSFileInfo</A
 386 > *info,
 387                                              gboolean recursing_will_loop,
 388                                              gpointer data,
 389                                              gboolean *recurse);</PRE
 390 ><P
 391 ></P
 392 ><P
 393 ></P
 394 ><TABLE
 395 CLASS="variablelist"
 396 BORDER="0"
 397 CELLSPACING="0"
 398 CELLPADDING="4"
 399 ><TBODY
 400 ><TR
 401 ><TD
 402 ALIGN="LEFT"
 403 VALIGN="TOP"
 404 ><A
 405 NAME="AEN2625"><SPAN
 406 STYLE="white-space: nowrap"
 407 ><TT
 408 CLASS="PARAMETER"
 409 ><I
 410 >rel_path</I
 411 ></TT
 412 >&nbsp;:</SPAN
 413 ></TD
 414 ><TD
 415 ALIGN="LEFT"
 416 VALIGN="TOP"
 417 ><P
 418 ></P
 419 ></TD
 420 ></TR
 421 ><TR
 422 ><TD
 423 ALIGN="LEFT"
 424 VALIGN="TOP"
 425 ><A
 426 NAME="AEN2630"><SPAN
 427 STYLE="white-space: nowrap"
 428 ><TT
 429 CLASS="PARAMETER"
 430 ><I
 431 >info</I
 432 ></TT
 433 >&nbsp;:</SPAN
 434 ></TD
 435 ><TD
 436 ALIGN="LEFT"
 437 VALIGN="TOP"
 438 ><P
 439 ></P
 440 ></TD
 441 ></TR
 442 ><TR
 443 ><TD
 444 ALIGN="LEFT"
 445 VALIGN="TOP"
 446 ><A
 447 NAME="AEN2635"><SPAN
 448 STYLE="white-space: nowrap"
 449 ><TT
 450 CLASS="PARAMETER"
 451 ><I
 452 >recursing_will_loop</I
 453 ></TT
 454 >&nbsp;:</SPAN
 455 ></TD
 456 ><TD
 457 ALIGN="LEFT"
 458 VALIGN="TOP"
 459 ><P
 460 ></P
 461 ></TD
 462 ></TR
 463 ><TR
 464 ><TD
 465 ALIGN="LEFT"
 466 VALIGN="TOP"
 467 ><A
 468 NAME="AEN2640"><SPAN
 469 STYLE="white-space: nowrap"
 470 ><TT
 471 CLASS="PARAMETER"
 472 ><I
 473 >data</I
 474 ></TT
 475 >&nbsp;:</SPAN
 476 ></TD
 477 ><TD
 478 ALIGN="LEFT"
 479 VALIGN="TOP"
 480 ><P
 481 ></P
 482 ></TD
 483 ></TR
 484 ><TR
 485 ><TD
 486 ALIGN="LEFT"
 487 VALIGN="TOP"
 488 ><A
 489 NAME="AEN2645"><SPAN
 490 STYLE="white-space: nowrap"
 491 ><TT
 492 CLASS="PARAMETER"
 493 ><I
 494 >recurse</I
 495 ></TT
 496 >&nbsp;:</SPAN
 497 ></TD
 498 ><TD
 499 ALIGN="LEFT"
 500 VALIGN="TOP"
 501 ><P
 502 ></P
 503 ></TD
 504 ></TR
 505 ><TR
 506 ><TD
 507 ALIGN="LEFT"
 508 VALIGN="TOP"
 509 ><A
 510 NAME="AEN2650"><SPAN
 511 STYLE="white-space: nowrap"
 512 ><SPAN
 513 CLASS="emphasis"
 514 ><I
 515 CLASS="EMPHASIS"
 516 >Returns</I
 517 ></SPAN
 518 > :</SPAN
 519 ></TD
 520 ><TD
 521 ALIGN="LEFT"
 522 VALIGN="TOP"
 523 ><P
 524 >&#13;</P
 525 ></TD
 526 ></TR
 527 ></TBODY
 528 ></TABLE
 529 ></DIV
 530 ><HR><DIV
 531 CLASS="REFSECT2"
 532 ><A
 533 NAME="AEN2655"
 534 ></A
 535 ><H3
 536 ><A
 537 NAME="GNOME-VFS-DIRECTORY-OPEN"
 538 ></A
 539 >gnome_vfs_directory_open ()</H3
 540 ><PRE
 541 CLASS="PROGRAMLISTING"
 542 ><A
 543 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 544 >GnomeVFSResult</A
 545 > gnome_vfs_directory_open     (GnomeVFSDirectoryHandle **handle,
 546                                              const gchar *text_uri,
 547                                              <A
 548 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 549 >GnomeVFSFileInfoOptions</A
 550 > options);</PRE
 551 ><P
 552 >Open directory <TT
 553 CLASS="PARAMETER"
 554 ><I
 555 >text_uri</I
 556 ></TT
 557 > for reading.  On return, @*handle will point to
 558 a <TT
 559 CLASS="LITERAL"
 560 >GnomeVFSDirectoryHandle</TT
 561 > object which can be used to read the directory
 562 entries one by one.</P
 563 ><P
 564 ></P
 565 ><P
 566 ></P
 567 ><TABLE
 568 CLASS="variablelist"
 569 BORDER="0"
 570 CELLSPACING="0"
 571 CELLPADDING="4"
 572 ><TBODY
 573 ><TR
 574 ><TD
 575 ALIGN="LEFT"
 576 VALIGN="TOP"
 577 ><A
 578 NAME="AEN2668"><SPAN
 579 STYLE="white-space: nowrap"
 580 ><TT
 581 CLASS="PARAMETER"
 582 ><I
 583 >handle</I
 584 ></TT
 585 >&nbsp;:</SPAN
 586 ></TD
 587 ><TD
 588 ALIGN="LEFT"
 589 VALIGN="TOP"
 590 ><P
 591 > A pointer to a pointer to a GnomeVFSDirectoryHandle object</P
 592 ></TD
 593 ></TR
 594 ><TR
 595 ><TD
 596 ALIGN="LEFT"
 597 VALIGN="TOP"
 598 ><A
 599 NAME="AEN2673"><SPAN
 600 STYLE="white-space: nowrap"
 601 ><TT
 602 CLASS="PARAMETER"
 603 ><I
 604 >text_uri</I
 605 ></TT
 606 >&nbsp;:</SPAN
 607 ></TD
 608 ><TD
 609 ALIGN="LEFT"
 610 VALIGN="TOP"
 611 ><P
 612 > String representing the URI to open</P
 613 ></TD
 614 ></TR
 615 ><TR
 616 ><TD
 617 ALIGN="LEFT"
 618 VALIGN="TOP"
 619 ><A
 620 NAME="AEN2678"><SPAN
 621 STYLE="white-space: nowrap"
 622 ><TT
 623 CLASS="PARAMETER"
 624 ><I
 625 >options</I
 626 ></TT
 627 >&nbsp;:</SPAN
 628 ></TD
 629 ><TD
 630 ALIGN="LEFT"
 631 VALIGN="TOP"
 632 ><P
 633 > Options for reading file information</P
 634 ></TD
 635 ></TR
 636 ><TR
 637 ><TD
 638 ALIGN="LEFT"
 639 VALIGN="TOP"
 640 ><A
 641 NAME="AEN2683"><SPAN
 642 STYLE="white-space: nowrap"
 643 ><SPAN
 644 CLASS="emphasis"
 645 ><I
 646 CLASS="EMPHASIS"
 647 >Returns</I
 648 ></SPAN
 649 > :</SPAN
 650 ></TD
 651 ><TD
 652 ALIGN="LEFT"
 653 VALIGN="TOP"
 654 ><P
 655 > An integer representing the result of the operation</P
 656 ></TD
 657 ></TR
 658 ></TBODY
 659 ></TABLE
 660 ></DIV
 661 ><HR><DIV
 662 CLASS="REFSECT2"
 663 ><A
 664 NAME="AEN2688"
 665 ></A
 666 ><H3
 667 ><A
 668 NAME="GNOME-VFS-DIRECTORY-OPEN-FROM-URI"
 669 ></A
 670 >gnome_vfs_directory_open_from_uri ()</H3
 671 ><PRE
 672 CLASS="PROGRAMLISTING"
 673 ><A
 674 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 675 >GnomeVFSResult</A
 676 > gnome_vfs_directory_open_from_uri
 677                                             (GnomeVFSDirectoryHandle **handle,
 678                                              GnomeVFSURI *uri,
 679                                              <A
 680 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 681 >GnomeVFSFileInfoOptions</A
 682 > options);</PRE
 683 ><P
 684 >Open directory <TT
 685 CLASS="PARAMETER"
 686 ><I
 687 >text_uri</I
 688 ></TT
 689 > for reading.  On return, @*handle will point to
 690 a <TT
 691 CLASS="LITERAL"
 692 >GnomeVFSDirectoryHandle</TT
 693 > object which can be used to read the directory
 694 entries one by one.</P
 695 ><P
 696 ></P
 697 ><P
 698 ></P
 699 ><TABLE
 700 CLASS="variablelist"
 701 BORDER="0"
 702 CELLSPACING="0"
 703 CELLPADDING="4"
 704 ><TBODY
 705 ><TR
 706 ><TD
 707 ALIGN="LEFT"
 708 VALIGN="TOP"
 709 ><A
 710 NAME="AEN2701"><SPAN
 711 STYLE="white-space: nowrap"
 712 ><TT
 713 CLASS="PARAMETER"
 714 ><I
 715 >handle</I
 716 ></TT
 717 >&nbsp;:</SPAN
 718 ></TD
 719 ><TD
 720 ALIGN="LEFT"
 721 VALIGN="TOP"
 722 ><P
 723 > A pointer to a pointer to a GnomeVFSDirectoryHandle object</P
 724 ></TD
 725 ></TR
 726 ><TR
 727 ><TD
 728 ALIGN="LEFT"
 729 VALIGN="TOP"
 730 ><A
 731 NAME="AEN2706"><SPAN
 732 STYLE="white-space: nowrap"
 733 ><TT
 734 CLASS="PARAMETER"
 735 ><I
 736 >uri</I
 737 ></TT
 738 >&nbsp;:</SPAN
 739 ></TD
 740 ><TD
 741 ALIGN="LEFT"
 742 VALIGN="TOP"
 743 ><P
 744 > URI to open</P
 745 ></TD
 746 ></TR
 747 ><TR
 748 ><TD
 749 ALIGN="LEFT"
 750 VALIGN="TOP"
 751 ><A
 752 NAME="AEN2711"><SPAN
 753 STYLE="white-space: nowrap"
 754 ><TT
 755 CLASS="PARAMETER"
 756 ><I
 757 >options</I
 758 ></TT
 759 >&nbsp;:</SPAN
 760 ></TD
 761 ><TD
 762 ALIGN="LEFT"
 763 VALIGN="TOP"
 764 ><P
 765 > Options for reading file information</P
 766 ></TD
 767 ></TR
 768 ><TR
 769 ><TD
 770 ALIGN="LEFT"
 771 VALIGN="TOP"
 772 ><A
 773 NAME="AEN2716"><SPAN
 774 STYLE="white-space: nowrap"
 775 ><SPAN
 776 CLASS="emphasis"
 777 ><I
 778 CLASS="EMPHASIS"
 779 >Returns</I
 780 ></SPAN
 781 > :</SPAN
 782 ></TD
 783 ><TD
 784 ALIGN="LEFT"
 785 VALIGN="TOP"
 786 ><P
 787 > An integer representing the result of the operation.</P
 788 ></TD
 789 ></TR
 790 ></TBODY
 791 ></TABLE
 792 ></DIV
 793 ><HR><DIV
 794 CLASS="REFSECT2"
 795 ><A
 796 NAME="AEN2721"
 797 ></A
 798 ><H3
 799 ><A
 800 NAME="GNOME-VFS-DIRECTORY-READ-NEXT"
 801 ></A
 802 >gnome_vfs_directory_read_next ()</H3
 803 ><PRE
 804 CLASS="PROGRAMLISTING"
 805 ><A
 806 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 807 >GnomeVFSResult</A
 808 > gnome_vfs_directory_read_next
 809                                             (GnomeVFSDirectoryHandle *handle,
 810                                              <A
 811 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 812 >GnomeVFSFileInfo</A
 813 > *file_info);</PRE
 814 ><P
 815 >Read the next directory entry from <TT
 816 CLASS="PARAMETER"
 817 ><I
 818 >handle</I
 819 ></TT
 820 >.</P
 821 ><P
 822 ></P
 823 ><P
 824 ></P
 825 ><TABLE
 826 CLASS="variablelist"
 827 BORDER="0"
 828 CELLSPACING="0"
 829 CELLPADDING="4"
 830 ><TBODY
 831 ><TR
 832 ><TD
 833 ALIGN="LEFT"
 834 VALIGN="TOP"
 835 ><A
 836 NAME="AEN2732"><SPAN
 837 STYLE="white-space: nowrap"
 838 ><TT
 839 CLASS="PARAMETER"
 840 ><I
 841 >handle</I
 842 ></TT
 843 >&nbsp;:</SPAN
 844 ></TD
 845 ><TD
 846 ALIGN="LEFT"
 847 VALIGN="TOP"
 848 ><P
 849 > A directory handle</P
 850 ></TD
 851 ></TR
 852 ><TR
 853 ><TD
 854 ALIGN="LEFT"
 855 VALIGN="TOP"
 856 ><A
 857 NAME="AEN2737"><SPAN
 858 STYLE="white-space: nowrap"
 859 ><TT
 860 CLASS="PARAMETER"
 861 ><I
 862 >file_info</I
 863 ></TT
 864 >&nbsp;:</SPAN
 865 ></TD
 866 ><TD
 867 ALIGN="LEFT"
 868 VALIGN="TOP"
 869 ><P
 870 > Pointer to a <TT
 871 CLASS="LITERAL"
 872 >GnomeVFSFileInfo</TT
 873 > struct where the data about
 874 the entry will be stored</P
 875 ></TD
 876 ></TR
 877 ><TR
 878 ><TD
 879 ALIGN="LEFT"
 880 VALIGN="TOP"
 881 ><A
 882 NAME="AEN2743"><SPAN
 883 STYLE="white-space: nowrap"
 884 ><SPAN
 885 CLASS="emphasis"
 886 ><I
 887 CLASS="EMPHASIS"
 888 >Returns</I
 889 ></SPAN
 890 > :</SPAN
 891 ></TD
 892 ><TD
 893 ALIGN="LEFT"
 894 VALIGN="TOP"
 895 ><P
 896 > An integer value representing the result of the operation.</P
 897 ></TD
 898 ></TR
 899 ></TBODY
 900 ></TABLE
 901 ></DIV
 902 ><HR><DIV
 903 CLASS="REFSECT2"
 904 ><A
 905 NAME="AEN2748"
 906 ></A
 907 ><H3
 908 ><A
 909 NAME="GNOME-VFS-DIRECTORY-CLOSE"
 910 ></A
 911 >gnome_vfs_directory_close ()</H3
 912 ><PRE
 913 CLASS="PROGRAMLISTING"
 914 ><A
 915 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 916 >GnomeVFSResult</A
 917 > gnome_vfs_directory_close    (GnomeVFSDirectoryHandle *handle);</PRE
 918 ><P
 919 >Close <TT
 920 CLASS="PARAMETER"
 921 ><I
 922 >handle</I
 923 ></TT
 924 >.</P
 925 ><P
 926 ></P
 927 ><P
 928 ></P
 929 ><TABLE
 930 CLASS="variablelist"
 931 BORDER="0"
 932 CELLSPACING="0"
 933 CELLPADDING="4"
 934 ><TBODY
 935 ><TR
 936 ><TD
 937 ALIGN="LEFT"
 938 VALIGN="TOP"
 939 ><A
 940 NAME="AEN2758"><SPAN
 941 STYLE="white-space: nowrap"
 942 ><TT
 943 CLASS="PARAMETER"
 944 ><I
 945 >handle</I
 946 ></TT
 947 >&nbsp;:</SPAN
 948 ></TD
 949 ><TD
 950 ALIGN="LEFT"
 951 VALIGN="TOP"
 952 ><P
 953 > A directory handle.</P
 954 ></TD
 955 ></TR
 956 ><TR
 957 ><TD
 958 ALIGN="LEFT"
 959 VALIGN="TOP"
 960 ><A
 961 NAME="AEN2763"><SPAN
 962 STYLE="white-space: nowrap"
 963 ><SPAN
 964 CLASS="emphasis"
 965 ><I
 966 CLASS="EMPHASIS"
 967 >Returns</I
 968 ></SPAN
 969 > :</SPAN
 970 ></TD
 971 ><TD
 972 ALIGN="LEFT"
 973 VALIGN="TOP"
 974 ><P
 975 > An integer representing the result of the operation.</P
 976 ></TD
 977 ></TR
 978 ></TBODY
 979 ></TABLE
 980 ></DIV
 981 ><HR><DIV
 982 CLASS="REFSECT2"
 983 ><A
 984 NAME="AEN2768"
 985 ></A
 986 ><H3
 987 ><A
 988 NAME="GNOME-VFS-DIRECTORY-VISIT"
 989 ></A
 990 >gnome_vfs_directory_visit ()</H3
 991 ><PRE
 992 CLASS="PROGRAMLISTING"
 993 ><A
 994 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 995 >GnomeVFSResult</A
 996 > gnome_vfs_directory_visit    (const gchar *uri,
 997                                              <A
 998 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 999 >GnomeVFSFileInfoOptions</A
1000 > info_options,
1001                                              <A
1002 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
1003 >GnomeVFSDirectoryVisitOptions</A
1004 > visit_options,
1005                                              <A
1006 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
1007 >GnomeVFSDirectoryVisitFunc</A
1008 > callback,
1009                                              gpointer data);</PRE
1010 ><P
1011 >Visit <TT
1012 CLASS="PARAMETER"
1013 ><I
1014 >uri</I
1015 ></TT
1016 >, retrieving information as specified by <TT
1017 CLASS="PARAMETER"
1018 ><I
1019 >info_options</I
1020 ></TT
1021 >.</P
1022 ><P
1023 ></P
1024 ><P
1025 ></P
1026 ><TABLE
1027 CLASS="variablelist"
1028 BORDER="0"
1029 CELLSPACING="0"
1030 CELLPADDING="4"
1031 ><TBODY
1032 ><TR
1033 ><TD
1034 ALIGN="LEFT"
1035 VALIGN="TOP"
1036 ><A
1037 NAME="AEN2783"><SPAN
1038 STYLE="white-space: nowrap"
1039 ><TT
1040 CLASS="PARAMETER"
1041 ><I
1042 >uri</I
1043 ></TT
1044 >&nbsp;:</SPAN
1045 ></TD
1046 ><TD
1047 ALIGN="LEFT"
1048 VALIGN="TOP"
1049 ><P
1050 > URI to start from</P
1051 ></TD
1052 ></TR
1053 ><TR
1054 ><TD
1055 ALIGN="LEFT"
1056 VALIGN="TOP"
1057 ><A
1058 NAME="AEN2788"><SPAN
1059 STYLE="white-space: nowrap"
1060 ><TT
1061 CLASS="PARAMETER"
1062 ><I
1063 >info_options</I
1064 ></TT
1065 >&nbsp;:</SPAN
1066 ></TD
1067 ><TD
1068 ALIGN="LEFT"
1069 VALIGN="TOP"
1070 ><P
1071 > Options specifying what kind of file information must be
1072 retrieved</P
1073 ></TD
1074 ></TR
1075 ><TR
1076 ><TD
1077 ALIGN="LEFT"
1078 VALIGN="TOP"
1079 ><A
1080 NAME="AEN2793"><SPAN
1081 STYLE="white-space: nowrap"
1082 ><TT
1083 CLASS="PARAMETER"
1084 ><I
1085 >visit_options</I
1086 ></TT
1087 >&nbsp;:</SPAN
1088 ></TD
1089 ><TD
1090 ALIGN="LEFT"
1091 VALIGN="TOP"
1092 ><P
1093 > Options specifying the type of visit</P
1094 ></TD
1095 ></TR
1096 ><TR
1097 ><TD
1098 ALIGN="LEFT"
1099 VALIGN="TOP"
1100 ><A
1101 NAME="AEN2798"><SPAN
1102 STYLE="white-space: nowrap"
1103 ><TT
1104 CLASS="PARAMETER"
1105 ><I
1106 >callback</I
1107 ></TT
1108 >&nbsp;:</SPAN
1109 ></TD
1110 ><TD
1111 ALIGN="LEFT"
1112 VALIGN="TOP"
1113 ><P
1114 > Callback to be called for every visited file</P
1115 ></TD
1116 ></TR
1117 ><TR
1118 ><TD
1119 ALIGN="LEFT"
1120 VALIGN="TOP"
1121 ><A
1122 NAME="AEN2803"><SPAN
1123 STYLE="white-space: nowrap"
1124 ><TT
1125 CLASS="PARAMETER"
1126 ><I
1127 >data</I
1128 ></TT
1129 >&nbsp;:</SPAN
1130 ></TD
1131 ><TD
1132 ALIGN="LEFT"
1133 VALIGN="TOP"
1134 ><P
1135 > Data to be passed to <TT
1136 CLASS="PARAMETER"
1137 ><I
1138 >callback</I
1139 ></TT
1140 > at each iteration</P
1141 ></TD
1142 ></TR
1143 ><TR
1144 ><TD
1145 ALIGN="LEFT"
1146 VALIGN="TOP"
1147 ><A
1148 NAME="AEN2809"><SPAN
1149 STYLE="white-space: nowrap"
1150 ><SPAN
1151 CLASS="emphasis"
1152 ><I
1153 CLASS="EMPHASIS"
1154 >Returns</I
1155 ></SPAN
1156 > :</SPAN
1157 ></TD
1158 ><TD
1159 ALIGN="LEFT"
1160 VALIGN="TOP"
1161 ><P
1162 > </P
1163 ></TD
1164 ></TR
1165 ></TBODY
1166 ></TABLE
1167 ></DIV
1168 ><HR><DIV
1169 CLASS="REFSECT2"
1170 ><A
1171 NAME="AEN2814"
1172 ></A
1173 ><H3
1174 ><A
1175 NAME="GNOME-VFS-DIRECTORY-VISIT-URI"
1176 ></A
1177 >gnome_vfs_directory_visit_uri ()</H3
1178 ><PRE
1179 CLASS="PROGRAMLISTING"
1180 ><A
1181 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1182 >GnomeVFSResult</A
1183 > gnome_vfs_directory_visit_uri
1184                                             (GnomeVFSURI *uri,
1185                                              <A
1186 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
1187 >GnomeVFSFileInfoOptions</A
1188 > info_options,
1189                                              <A
1190 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
1191 >GnomeVFSDirectoryVisitOptions</A
1192 > visit_options,
1193                                              <A
1194 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
1195 >GnomeVFSDirectoryVisitFunc</A
1196 > callback,
1197                                              gpointer data);</PRE
1198 ><P
1199 >Visit <TT
1200 CLASS="PARAMETER"
1201 ><I
1202 >uri</I
1203 ></TT
1204 >, retrieving information as specified by <TT
1205 CLASS="PARAMETER"
1206 ><I
1207 >info_options</I
1208 ></TT
1209 >.</P
1210 ><P
1211 ></P
1212 ><P
1213 ></P
1214 ><TABLE
1215 CLASS="variablelist"
1216 BORDER="0"
1217 CELLSPACING="0"
1218 CELLPADDING="4"
1219 ><TBODY
1220 ><TR
1221 ><TD
1222 ALIGN="LEFT"
1223 VALIGN="TOP"
1224 ><A
1225 NAME="AEN2829"><SPAN
1226 STYLE="white-space: nowrap"
1227 ><TT
1228 CLASS="PARAMETER"
1229 ><I
1230 >uri</I
1231 ></TT
1232 >&nbsp;:</SPAN
1233 ></TD
1234 ><TD
1235 ALIGN="LEFT"
1236 VALIGN="TOP"
1237 ><P
1238 > URI to start from</P
1239 ></TD
1240 ></TR
1241 ><TR
1242 ><TD
1243 ALIGN="LEFT"
1244 VALIGN="TOP"
1245 ><A
1246 NAME="AEN2834"><SPAN
1247 STYLE="white-space: nowrap"
1248 ><TT
1249 CLASS="PARAMETER"
1250 ><I
1251 >info_options</I
1252 ></TT
1253 >&nbsp;:</SPAN
1254 ></TD
1255 ><TD
1256 ALIGN="LEFT"
1257 VALIGN="TOP"
1258 ><P
1259 > Options specifying what kind of file information must be
1260 retrieved</P
1261 ></TD
1262 ></TR
1263 ><TR
1264 ><TD
1265 ALIGN="LEFT"
1266 VALIGN="TOP"
1267 ><A
1268 NAME="AEN2839"><SPAN
1269 STYLE="white-space: nowrap"
1270 ><TT
1271 CLASS="PARAMETER"
1272 ><I
1273 >visit_options</I
1274 ></TT
1275 >&nbsp;:</SPAN
1276 ></TD
1277 ><TD
1278 ALIGN="LEFT"
1279 VALIGN="TOP"
1280 ><P
1281 > Options specifying the type of visit</P
1282 ></TD
1283 ></TR
1284 ><TR
1285 ><TD
1286 ALIGN="LEFT"
1287 VALIGN="TOP"
1288 ><A
1289 NAME="AEN2844"><SPAN
1290 STYLE="white-space: nowrap"
1291 ><TT
1292 CLASS="PARAMETER"
1293 ><I
1294 >callback</I
1295 ></TT
1296 >&nbsp;:</SPAN
1297 ></TD
1298 ><TD
1299 ALIGN="LEFT"
1300 VALIGN="TOP"
1301 ><P
1302 > Callback to be called for every visited file</P
1303 ></TD
1304 ></TR
1305 ><TR
1306 ><TD
1307 ALIGN="LEFT"
1308 VALIGN="TOP"
1309 ><A
1310 NAME="AEN2849"><SPAN
1311 STYLE="white-space: nowrap"
1312 ><TT
1313 CLASS="PARAMETER"
1314 ><I
1315 >data</I
1316 ></TT
1317 >&nbsp;:</SPAN
1318 ></TD
1319 ><TD
1320 ALIGN="LEFT"
1321 VALIGN="TOP"
1322 ><P
1323 > Data to be passed to <TT
1324 CLASS="PARAMETER"
1325 ><I
1326 >callback</I
1327 ></TT
1328 > at each iteration</P
1329 ></TD
1330 ></TR
1331 ><TR
1332 ><TD
1333 ALIGN="LEFT"
1334 VALIGN="TOP"
1335 ><A
1336 NAME="AEN2855"><SPAN
1337 STYLE="white-space: nowrap"
1338 ><SPAN
1339 CLASS="emphasis"
1340 ><I
1341 CLASS="EMPHASIS"
1342 >Returns</I
1343 ></SPAN
1344 > :</SPAN
1345 ></TD
1346 ><TD
1347 ALIGN="LEFT"
1348 VALIGN="TOP"
1349 ><P
1350 > A result code indicating whether the operation succeeded. &#13;</P
1351 ></TD
1352 ></TR
1353 ></TBODY
1354 ></TABLE
1355 ></DIV
1356 ><HR><DIV
1357 CLASS="REFSECT2"
1358 ><A
1359 NAME="AEN2860"
1360 ></A
1361 ><H3
1362 ><A
1363 NAME="GNOME-VFS-DIRECTORY-VISIT-FILES"
1364 ></A
1365 >gnome_vfs_directory_visit_files ()</H3
1366 ><PRE
1367 CLASS="PROGRAMLISTING"
1368 ><A
1369 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1370 >GnomeVFSResult</A
1371 > gnome_vfs_directory_visit_files
1372                                             (const gchar *text_uri,
1373                                              GList *file_list,
1374                                              <A
1375 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
1376 >GnomeVFSFileInfoOptions</A
1377 > info_options,
1378                                              <A
1379 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
1380 >GnomeVFSDirectoryVisitOptions</A
1381 > visit_options,
1382                                              <A
1383 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
1384 >GnomeVFSDirectoryVisitFunc</A
1385 > callback,
1386                                              gpointer data);</PRE
1387 ><P
1388 >Fetches information about a list of files in a base URI <TT
1389 CLASS="PARAMETER"
1390 ><I
1391 >uri</I
1392 ></TT
1393 >.</P
1394 ><P
1395 ></P
1396 ><P
1397 ></P
1398 ><TABLE
1399 CLASS="variablelist"
1400 BORDER="0"
1401 CELLSPACING="0"
1402 CELLPADDING="4"
1403 ><TBODY
1404 ><TR
1405 ><TD
1406 ALIGN="LEFT"
1407 VALIGN="TOP"
1408 ><A
1409 NAME="AEN2875"><SPAN
1410 STYLE="white-space: nowrap"
1411 ><TT
1412 CLASS="PARAMETER"
1413 ><I
1414 >text_uri</I
1415 ></TT
1416 >&nbsp;:</SPAN
1417 ></TD
1418 ><TD
1419 ALIGN="LEFT"
1420 VALIGN="TOP"
1421 ><P
1422 > string representing the URI of a directory to "visit" the files in</P
1423 ></TD
1424 ></TR
1425 ><TR
1426 ><TD
1427 ALIGN="LEFT"
1428 VALIGN="TOP"
1429 ><A
1430 NAME="AEN2880"><SPAN
1431 STYLE="white-space: nowrap"
1432 ><TT
1433 CLASS="PARAMETER"
1434 ><I
1435 >file_list</I
1436 ></TT
1437 >&nbsp;:</SPAN
1438 ></TD
1439 ><TD
1440 ALIGN="LEFT"
1441 VALIGN="TOP"
1442 ><P
1443 > GList of char *s of file names in <TT
1444 CLASS="PARAMETER"
1445 ><I
1446 >uri</I
1447 ></TT
1448 > to visit</P
1449 ></TD
1450 ></TR
1451 ><TR
1452 ><TD
1453 ALIGN="LEFT"
1454 VALIGN="TOP"
1455 ><A
1456 NAME="AEN2886"><SPAN
1457 STYLE="white-space: nowrap"
1458 ><TT
1459 CLASS="PARAMETER"
1460 ><I
1461 >info_options</I
1462 ></TT
1463 >&nbsp;:</SPAN
1464 ></TD
1465 ><TD
1466 ALIGN="LEFT"
1467 VALIGN="TOP"
1468 ><P
1469 > bitmask controlling the type of information to fetch</P
1470 ></TD
1471 ></TR
1472 ><TR
1473 ><TD
1474 ALIGN="LEFT"
1475 VALIGN="TOP"
1476 ><A
1477 NAME="AEN2891"><SPAN
1478 STYLE="white-space: nowrap"
1479 ><TT
1480 CLASS="PARAMETER"
1481 ><I
1482 >visit_options</I
1483 ></TT
1484 >&nbsp;:</SPAN
1485 ></TD
1486 ><TD
1487 ALIGN="LEFT"
1488 VALIGN="TOP"
1489 ><P
1490 > options controlling e.g. loop prevention, and filesystem checks.
1491 Affects the way visiting is done.</P
1492 ></TD
1493 ></TR
1494 ><TR
1495 ><TD
1496 ALIGN="LEFT"
1497 VALIGN="TOP"
1498 ><A
1499 NAME="AEN2896"><SPAN
1500 STYLE="white-space: nowrap"
1501 ><TT
1502 CLASS="PARAMETER"
1503 ><I
1504 >callback</I
1505 ></TT
1506 >&nbsp;:</SPAN
1507 ></TD
1508 ><TD
1509 ALIGN="LEFT"
1510 VALIGN="TOP"
1511 ><P
1512 > function to call with the file info structs</P
1513 ></TD
1514 ></TR
1515 ><TR
1516 ><TD
1517 ALIGN="LEFT"
1518 VALIGN="TOP"
1519 ><A
1520 NAME="AEN2901"><SPAN
1521 STYLE="white-space: nowrap"
1522 ><TT
1523 CLASS="PARAMETER"
1524 ><I
1525 >data</I
1526 ></TT
1527 >&nbsp;:</SPAN
1528 ></TD
1529 ><TD
1530 ALIGN="LEFT"
1531 VALIGN="TOP"
1532 ><P
1533 > data to pass to <TT
1534 CLASS="PARAMETER"
1535 ><I
1536 >callback</I
1537 ></TT
1538 >.</P
1539 ></TD
1540 ></TR
1541 ><TR
1542 ><TD
1543 ALIGN="LEFT"
1544 VALIGN="TOP"
1545 ><A
1546 NAME="AEN2907"><SPAN
1547 STYLE="white-space: nowrap"
1548 ><SPAN
1549 CLASS="emphasis"
1550 ><I
1551 CLASS="EMPHASIS"
1552 >Returns</I
1553 ></SPAN
1554 > :</SPAN
1555 ></TD
1556 ><TD
1557 ALIGN="LEFT"
1558 VALIGN="TOP"
1559 ><P
1560 > a GnomeVFSResult indication the success of the operation</P
1561 ></TD
1562 ></TR
1563 ></TBODY
1564 ></TABLE
1565 ></DIV
1566 ><HR><DIV
1567 CLASS="REFSECT2"
1568 ><A
1569 NAME="AEN2912"
1570 ></A
1571 ><H3
1572 ><A
1573 NAME="GNOME-VFS-DIRECTORY-VISIT-FILES-AT-URI"
1574 ></A
1575 >gnome_vfs_directory_visit_files_at_uri ()</H3
1576 ><PRE
1577 CLASS="PROGRAMLISTING"
1578 ><A
1579 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1580 >GnomeVFSResult</A
1581 > gnome_vfs_directory_visit_files_at_uri
1582                                             (GnomeVFSURI *uri,
1583                                              GList *file_list,
1584                                              <A
1585 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
1586 >GnomeVFSFileInfoOptions</A
1587 > info_options,
1588                                              <A
1589 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITOPTIONS"
1590 >GnomeVFSDirectoryVisitOptions</A
1591 > visit_options,
1592                                              <A
1593 HREF="gnome-vfs-gnome-vfs-directory.html#GNOMEVFSDIRECTORYVISITFUNC"
1594 >GnomeVFSDirectoryVisitFunc</A
1595 > callback,
1596                                              gpointer data);</PRE
1597 ><P
1598 >Fetches information about a list of files in a base URI <TT
1599 CLASS="PARAMETER"
1600 ><I
1601 >uri</I
1602 ></TT
1603 >.</P
1604 ><P
1605 ></P
1606 ><P
1607 ></P
1608 ><TABLE
1609 CLASS="variablelist"
1610 BORDER="0"
1611 CELLSPACING="0"
1612 CELLPADDING="4"
1613 ><TBODY
1614 ><TR
1615 ><TD
1616 ALIGN="LEFT"
1617 VALIGN="TOP"
1618 ><A
1619 NAME="AEN2927"><SPAN
1620 STYLE="white-space: nowrap"
1621 ><TT
1622 CLASS="PARAMETER"
1623 ><I
1624 >uri</I
1625 ></TT
1626 >&nbsp;:</SPAN
1627 ></TD
1628 ><TD
1629 ALIGN="LEFT"
1630 VALIGN="TOP"
1631 ><P
1632 > URI of a directory to "visit" the files in</P
1633 ></TD
1634 ></TR
1635 ><TR
1636 ><TD
1637 ALIGN="LEFT"
1638 VALIGN="TOP"
1639 ><A
1640 NAME="AEN2932"><SPAN
1641 STYLE="white-space: nowrap"
1642 ><TT
1643 CLASS="PARAMETER"
1644 ><I
1645 >file_list</I
1646 ></TT
1647 >&nbsp;:</SPAN
1648 ></TD
1649 ><TD
1650 ALIGN="LEFT"
1651 VALIGN="TOP"
1652 ><P
1653 > GList of char *s of file names in <TT
1654 CLASS="PARAMETER"
1655 ><I
1656 >uri</I
1657 ></TT
1658 > to visit</P
1659 ></TD
1660 ></TR
1661 ><TR
1662 ><TD
1663 ALIGN="LEFT"
1664 VALIGN="TOP"
1665 ><A
1666 NAME="AEN2938"><SPAN
1667 STYLE="white-space: nowrap"
1668 ><TT
1669 CLASS="PARAMETER"
1670 ><I
1671 >info_options</I
1672 ></TT
1673 >&nbsp;:</SPAN
1674 ></TD
1675 ><TD
1676 ALIGN="LEFT"
1677 VALIGN="TOP"
1678 ><P
1679 > bitmask controlling the type of information to fetch</P
1680 ></TD
1681 ></TR
1682 ><TR
1683 ><TD
1684 ALIGN="LEFT"
1685 VALIGN="TOP"
1686 ><A
1687 NAME="AEN2943"><SPAN
1688 STYLE="white-space: nowrap"
1689 ><TT
1690 CLASS="PARAMETER"
1691 ><I
1692 >visit_options</I
1693 ></TT
1694 >&nbsp;:</SPAN
1695 ></TD
1696 ><TD
1697 ALIGN="LEFT"
1698 VALIGN="TOP"
1699 ><P
1700 > options controlling e.g. loop prevention, and filesystem checks.
1701 Affects the way visiting is done.</P
1702 ></TD
1703 ></TR
1704 ><TR
1705 ><TD
1706 ALIGN="LEFT"
1707 VALIGN="TOP"
1708 ><A
1709 NAME="AEN2948"><SPAN
1710 STYLE="white-space: nowrap"
1711 ><TT
1712 CLASS="PARAMETER"
1713 ><I
1714 >callback</I
1715 ></TT
1716 >&nbsp;:</SPAN
1717 ></TD
1718 ><TD
1719 ALIGN="LEFT"
1720 VALIGN="TOP"
1721 ><P
1722 > function to call with the file info structs</P
1723 ></TD
1724 ></TR
1725 ><TR
1726 ><TD
1727 ALIGN="LEFT"
1728 VALIGN="TOP"
1729 ><A
1730 NAME="AEN2953"><SPAN
1731 STYLE="white-space: nowrap"
1732 ><TT
1733 CLASS="PARAMETER"
1734 ><I
1735 >data</I
1736 ></TT
1737 >&nbsp;:</SPAN
1738 ></TD
1739 ><TD
1740 ALIGN="LEFT"
1741 VALIGN="TOP"
1742 ><P
1743 > data to pass to <TT
1744 CLASS="PARAMETER"
1745 ><I
1746 >callback</I
1747 ></TT
1748 >.</P
1749 ></TD
1750 ></TR
1751 ><TR
1752 ><TD
1753 ALIGN="LEFT"
1754 VALIGN="TOP"
1755 ><A
1756 NAME="AEN2959"><SPAN
1757 STYLE="white-space: nowrap"
1758 ><SPAN
1759 CLASS="emphasis"
1760 ><I
1761 CLASS="EMPHASIS"
1762 >Returns</I
1763 ></SPAN
1764 > :</SPAN
1765 ></TD
1766 ><TD
1767 ALIGN="LEFT"
1768 VALIGN="TOP"
1769 ><P
1770 > a GnomeVFSResult indication the success of the operation</P
1771 ></TD
1772 ></TR
1773 ></TBODY
1774 ></TABLE
1775 ></DIV
1776 ><HR><DIV
1777 CLASS="REFSECT2"
1778 ><A
1779 NAME="AEN2964"
1780 ></A
1781 ><H3
1782 ><A
1783 NAME="GNOME-VFS-DIRECTORY-LIST-LOAD"
1784 ></A
1785 >gnome_vfs_directory_list_load ()</H3
1786 ><PRE
1787 CLASS="PROGRAMLISTING"
1788 ><A
1789 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1790 >GnomeVFSResult</A
1791 > gnome_vfs_directory_list_load
1792                                             (GList **list,
1793                                              const gchar *text_uri,
1794                                              <A
1795 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
1796 >GnomeVFSFileInfoOptions</A
1797 > options);</PRE
1798 ><P
1799 >Load a directory from <TT
1800 CLASS="PARAMETER"
1801 ><I
1802 >text_uri</I
1803 ></TT
1804 > with the specified <TT
1805 CLASS="PARAMETER"
1806 ><I
1807 >options</I
1808 ></TT
1809 >
1810 into a list.</P
1811 ><P
1812 ></P
1813 ><P
1814 ></P
1815 ><TABLE
1816 CLASS="variablelist"
1817 BORDER="0"
1818 CELLSPACING="0"
1819 CELLPADDING="4"
1820 ><TBODY
1821 ><TR
1822 ><TD
1823 ALIGN="LEFT"
1824 VALIGN="TOP"
1825 ><A
1826 NAME="AEN2977"><SPAN
1827 STYLE="white-space: nowrap"
1828 ><TT
1829 CLASS="PARAMETER"
1830 ><I
1831 >list</I
1832 ></TT
1833 >&nbsp;:</SPAN
1834 ></TD
1835 ><TD
1836 ALIGN="LEFT"
1837 VALIGN="TOP"
1838 ><P
1839 > An address of a pointer to a list of GnomeVFSFileInfo</P
1840 ></TD
1841 ></TR
1842 ><TR
1843 ><TD
1844 ALIGN="LEFT"
1845 VALIGN="TOP"
1846 ><A
1847 NAME="AEN2982"><SPAN
1848 STYLE="white-space: nowrap"
1849 ><TT
1850 CLASS="PARAMETER"
1851 ><I
1852 >text_uri</I
1853 ></TT
1854 >&nbsp;:</SPAN
1855 ></TD
1856 ><TD
1857 ALIGN="LEFT"
1858 VALIGN="TOP"
1859 ><P
1860 > A text URI</P
1861 ></TD
1862 ></TR
1863 ><TR
1864 ><TD
1865 ALIGN="LEFT"
1866 VALIGN="TOP"
1867 ><A
1868 NAME="AEN2987"><SPAN
1869 STYLE="white-space: nowrap"
1870 ><TT
1871 CLASS="PARAMETER"
1872 ><I
1873 >options</I
1874 ></TT
1875 >&nbsp;:</SPAN
1876 ></TD
1877 ><TD
1878 ALIGN="LEFT"
1879 VALIGN="TOP"
1880 ><P
1881 > Options for loading the directory </P
1882 ></TD
1883 ></TR
1884 ><TR
1885 ><TD
1886 ALIGN="LEFT"
1887 VALIGN="TOP"
1888 ><A
1889 NAME="AEN2992"><SPAN
1890 STYLE="white-space: nowrap"
1891 ><SPAN
1892 CLASS="emphasis"
1893 ><I
1894 CLASS="EMPHASIS"
1895 >Returns</I
1896 ></SPAN
1897 > :</SPAN
1898 ></TD
1899 ><TD
1900 ALIGN="LEFT"
1901 VALIGN="TOP"
1902 ><P
1903 > An integer representing the result of the operation.</P
1904 ></TD
1905 ></TR
1906 ></TBODY
1907 ></TABLE
1908 ></DIV
1909 ><HR><DIV
1910 CLASS="REFSECT2"
1911 ><A
1912 NAME="AEN2997"
1913 ></A
1914 ><H3
1915 ><A
1916 NAME="GNOME-VFS-MAKE-DIRECTORY-FOR-URI"
1917 ></A
1918 >gnome_vfs_make_directory_for_uri ()</H3
1919 ><PRE
1920 CLASS="PROGRAMLISTING"
1921 ><A
1922 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1923 >GnomeVFSResult</A
1924 > gnome_vfs_make_directory_for_uri
1925                                             (GnomeVFSURI *uri,
1926                                              guint perm);</PRE
1927 ><P
1928 >Create a directory at <TT
1929 CLASS="PARAMETER"
1930 ><I
1931 >uri</I
1932 ></TT
1933 >. Only succeeds if a file or directory
1934 does not already exist at <TT
1935 CLASS="PARAMETER"
1936 ><I
1937 >uri</I
1938 ></TT
1939 >.</P
1940 ><P
1941 ></P
1942 ><P
1943 ></P
1944 ><TABLE
1945 CLASS="variablelist"
1946 BORDER="0"
1947 CELLSPACING="0"
1948 CELLPADDING="4"
1949 ><TBODY
1950 ><TR
1951 ><TD
1952 ALIGN="LEFT"
1953 VALIGN="TOP"
1954 ><A
1955 NAME="AEN3009"><SPAN
1956 STYLE="white-space: nowrap"
1957 ><TT
1958 CLASS="PARAMETER"
1959 ><I
1960 >uri</I
1961 ></TT
1962 >&nbsp;:</SPAN
1963 ></TD
1964 ><TD
1965 ALIGN="LEFT"
1966 VALIGN="TOP"
1967 ><P
1968 > URI of the directory to be created</P
1969 ></TD
1970 ></TR
1971 ><TR
1972 ><TD
1973 ALIGN="LEFT"
1974 VALIGN="TOP"
1975 ><A
1976 NAME="AEN3014"><SPAN
1977 STYLE="white-space: nowrap"
1978 ><TT
1979 CLASS="PARAMETER"
1980 ><I
1981 >perm</I
1982 ></TT
1983 >&nbsp;:</SPAN
1984 ></TD
1985 ><TD
1986 ALIGN="LEFT"
1987 VALIGN="TOP"
1988 ><P
1989 > Unix-style permissions for the newly created directory</P
1990 ></TD
1991 ></TR
1992 ><TR
1993 ><TD
1994 ALIGN="LEFT"
1995 VALIGN="TOP"
1996 ><A
1997 NAME="AEN3019"><SPAN
1998 STYLE="white-space: nowrap"
1999 ><SPAN
2000 CLASS="emphasis"
2001 ><I
2002 CLASS="EMPHASIS"
2003 >Returns</I
2004 ></SPAN
2005 > :</SPAN
2006 ></TD
2007 ><TD
2008 ALIGN="LEFT"
2009 VALIGN="TOP"
2010 ><P
2011 > An integer representing the result of the operation</P
2012 ></TD
2013 ></TR
2014 ></TBODY
2015 ></TABLE
2016 ></DIV
2017 ><HR><DIV
2018 CLASS="REFSECT2"
2019 ><A
2020 NAME="AEN3024"
2021 ></A
2022 ><H3
2023 ><A
2024 NAME="GNOME-VFS-MAKE-DIRECTORY"
2025 ></A
2026 >gnome_vfs_make_directory ()</H3
2027 ><PRE
2028 CLASS="PROGRAMLISTING"
2029 ><A
2030 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2031 >GnomeVFSResult</A
2032 > gnome_vfs_make_directory     (const gchar *text_uri,
2033                                              guint perm);</PRE
2034 ><P
2035 >Create <TT
2036 CLASS="PARAMETER"
2037 ><I
2038 >text_uri</I
2039 ></TT
2040 > as a directory.</P
2041 ><P
2042 ></P
2043 ><P
2044 ></P
2045 ><TABLE
2046 CLASS="variablelist"
2047 BORDER="0"
2048 CELLSPACING="0"
2049 CELLPADDING="4"
2050 ><TBODY
2051 ><TR
2052 ><TD
2053 ALIGN="LEFT"
2054 VALIGN="TOP"
2055 ><A
2056 NAME="AEN3035"><SPAN
2057 STYLE="white-space: nowrap"
2058 ><TT
2059 CLASS="PARAMETER"
2060 ><I
2061 >text_uri</I
2062 ></TT
2063 >&nbsp;:</SPAN
2064 ></TD
2065 ><TD
2066 ALIGN="LEFT"
2067 VALIGN="TOP"
2068 ><P
2069 > URI of the directory to be created</P
2070 ></TD
2071 ></TR
2072 ><TR
2073 ><TD
2074 ALIGN="LEFT"
2075 VALIGN="TOP"
2076 ><A
2077 NAME="AEN3040"><SPAN
2078 STYLE="white-space: nowrap"
2079 ><TT
2080 CLASS="PARAMETER"
2081 ><I
2082 >perm</I
2083 ></TT
2084 >&nbsp;:</SPAN
2085 ></TD
2086 ><TD
2087 ALIGN="LEFT"
2088 VALIGN="TOP"
2089 ><P
2090 > Unix-style permissions for the newly created directory</P
2091 ></TD
2092 ></TR
2093 ><TR
2094 ><TD
2095 ALIGN="LEFT"
2096 VALIGN="TOP"
2097 ><A
2098 NAME="AEN3045"><SPAN
2099 STYLE="white-space: nowrap"
2100 ><SPAN
2101 CLASS="emphasis"
2102 ><I
2103 CLASS="EMPHASIS"
2104 >Returns</I
2105 ></SPAN
2106 > :</SPAN
2107 ></TD
2108 ><TD
2109 ALIGN="LEFT"
2110 VALIGN="TOP"
2111 ><P
2112 > An integer representing the result of the operation</P
2113 ></TD
2114 ></TR
2115 ></TBODY
2116 ></TABLE
2117 ></DIV
2118 ><HR><DIV
2119 CLASS="REFSECT2"
2120 ><A
2121 NAME="AEN3050"
2122 ></A
2123 ><H3
2124 ><A
2125 NAME="GNOME-VFS-REMOVE-DIRECTORY-FROM-URI"
2126 ></A
2127 >gnome_vfs_remove_directory_from_uri ()</H3
2128 ><PRE
2129 CLASS="PROGRAMLISTING"
2130 ><A
2131 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2132 >GnomeVFSResult</A
2133 > gnome_vfs_remove_directory_from_uri
2134                                             (GnomeVFSURI *uri);</PRE
2135 ><P
2136 >Remove <TT
2137 CLASS="PARAMETER"
2138 ><I
2139 >uri</I
2140 ></TT
2141 >.  <TT
2142 CLASS="PARAMETER"
2143 ><I
2144 >uri</I
2145 ></TT
2146 > must be an empty directory.</P
2147 ><P
2148 ></P
2149 ><P
2150 ></P
2151 ><TABLE
2152 CLASS="variablelist"
2153 BORDER="0"
2154 CELLSPACING="0"
2155 CELLPADDING="4"
2156 ><TBODY
2157 ><TR
2158 ><TD
2159 ALIGN="LEFT"
2160 VALIGN="TOP"
2161 ><A
2162 NAME="AEN3061"><SPAN
2163 STYLE="white-space: nowrap"
2164 ><TT
2165 CLASS="PARAMETER"
2166 ><I
2167 >uri</I
2168 ></TT
2169 >&nbsp;:</SPAN
2170 ></TD
2171 ><TD
2172 ALIGN="LEFT"
2173 VALIGN="TOP"
2174 ><P
2175 > URI of the directory to be removed</P
2176 ></TD
2177 ></TR
2178 ><TR
2179 ><TD
2180 ALIGN="LEFT"
2181 VALIGN="TOP"
2182 ><A
2183 NAME="AEN3066"><SPAN
2184 STYLE="white-space: nowrap"
2185 ><SPAN
2186 CLASS="emphasis"
2187 ><I
2188 CLASS="EMPHASIS"
2189 >Returns</I
2190 ></SPAN
2191 > :</SPAN
2192 ></TD
2193 ><TD
2194 ALIGN="LEFT"
2195 VALIGN="TOP"
2196 ><P
2197 > An integer representing the result of the operation</P
2198 ></TD
2199 ></TR
2200 ></TBODY
2201 ></TABLE
2202 ></DIV
2203 ><HR><DIV
2204 CLASS="REFSECT2"
2205 ><A
2206 NAME="AEN3071"
2207 ></A
2208 ><H3
2209 ><A
2210 NAME="GNOME-VFS-REMOVE-DIRECTORY"
2211 ></A
2212 >gnome_vfs_remove_directory ()</H3
2213 ><PRE
2214 CLASS="PROGRAMLISTING"
2215 ><A
2216 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2217 >GnomeVFSResult</A
2218 > gnome_vfs_remove_directory   (const gchar *text_uri);</PRE
2219 ><P
2220 >Remove <TT
2221 CLASS="PARAMETER"
2222 ><I
2223 >text_uri</I
2224 ></TT
2225 >.  <TT
2226 CLASS="PARAMETER"
2227 ><I
2228 >text_uri</I
2229 ></TT
2230 > must be an empty directory.</P
2231 ><P
2232 ></P
2233 ><P
2234 ></P
2235 ><TABLE
2236 CLASS="variablelist"
2237 BORDER="0"
2238 CELLSPACING="0"
2239 CELLPADDING="4"
2240 ><TBODY
2241 ><TR
2242 ><TD
2243 ALIGN="LEFT"
2244 VALIGN="TOP"
2245 ><A
2246 NAME="AEN3082"><SPAN
2247 STYLE="white-space: nowrap"
2248 ><TT
2249 CLASS="PARAMETER"
2250 ><I
2251 >text_uri</I
2252 ></TT
2253 >&nbsp;:</SPAN
2254 ></TD
2255 ><TD
2256 ALIGN="LEFT"
2257 VALIGN="TOP"
2258 ><P
2259 > URI of the directory to be removed</P
2260 ></TD
2261 ></TR
2262 ><TR
2263 ><TD
2264 ALIGN="LEFT"
2265 VALIGN="TOP"
2266 ><A
2267 NAME="AEN3087"><SPAN
2268 STYLE="white-space: nowrap"
2269 ><SPAN
2270 CLASS="emphasis"
2271 ><I
2272 CLASS="EMPHASIS"
2273 >Returns</I
2274 ></SPAN
2275 > :</SPAN
2276 ></TD
2277 ><TD
2278 ALIGN="LEFT"
2279 VALIGN="TOP"
2280 ><P
2281 > An integer representing the result of the operation</P
2282 ></TD
2283 ></TR
2284 ></TBODY
2285 ></TABLE
2286 ></DIV
2287 ></DIV
2288 ><TABLE
2289 CLASS="navigation"
2290 WIDTH="100%"
2291 SUMMARY="Navigation footer"
2292 CELLPADDING="2"
2293 CELLSPACING="2"
2294 ><TR
2295 VALIGN="middle"
2296 ><TD
2297 ALIGN="left"
2298 ><A
2299 ACCESSKEY="p"
2300 HREF="directory-operations.html"
2301 ><B
2302 >&lt;&lt;&lt;&nbsp;Directories</B
2303 ></A
2304 ></TD
2305 ><TD
2306 ALIGN="right"
2307 ><A
2308 ACCESSKEY="n"
2309 HREF="gnome-vfs-gnome-vfs-find-directory.html"
2310 ><B
2311 >Locating Standard Directories&nbsp;&gt;&gt;&gt;</B
2312 ></A
2313 ></TD
2314 ></TR
2315 ></TABLE
2316 ></BODY
2317 ></HTML
2318 >