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

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >File 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="Files"
  14 HREF="file-operations.html"><LINK
  15 REL="PREVIOUS"
  16 TITLE="Initialization/Shutdown"
  17 HREF="gnome-vfs-gnome-vfs-init.html"><LINK
  18 REL="NEXT"
  19 TITLE="Asynchronous File Operations"
  20 HREF="gnome-vfs-gnome-vfs-async-ops.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="gnome-vfs-gnome-vfs-init.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="file-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-async-ops.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-OPS"
 122 ></A
 123 >File Operations</H1
 124 ><DIV
 125 CLASS="REFNAMEDIV"
 126 ><A
 127 NAME="AEN143"
 128 ></A
 129 ><H2
 130 >Name</H2
 131 >File Operations&nbsp;--&nbsp;basic POSIX-style file operations</DIV
 132 ><DIV
 133 CLASS="REFSYNOPSISDIV"
 134 ><A
 135 NAME="AEN146"
 136 ></A
 137 ><H2
 138 >Synopsis</H2
 139 ><PRE
 140 CLASS="SYNOPSIS"
 141 >&#13;
 142
 143 <A
 144 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 145 >GnomeVFSResult</A
 146 > <A
 147 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-OPEN"
 148 >gnome_vfs_open</A
 149 >               (GnomeVFSHandle **handle,
 150                                              const gchar *text_uri,
 151                                              <A
 152 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 153 >GnomeVFSOpenMode</A
 154 > open_mode);
 155 <A
 156 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 157 >GnomeVFSResult</A
 158 > <A
 159 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-OPEN-URI"
 160 >gnome_vfs_open_uri</A
 161 >           (GnomeVFSHandle **handle,
 162                                              GnomeVFSURI *uri,
 163                                              <A
 164 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 165 >GnomeVFSOpenMode</A
 166 > open_mode);
 167 <A
 168 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 169 >GnomeVFSResult</A
 170 > <A
 171 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-CREATE"
 172 >gnome_vfs_create</A
 173 >             (GnomeVFSHandle **handle,
 174                                              const gchar *text_uri,
 175                                              <A
 176 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 177 >GnomeVFSOpenMode</A
 178 > open_mode,
 179                                              gboolean exclusive,
 180                                              guint perm);
 181 <A
 182 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 183 >GnomeVFSResult</A
 184 > <A
 185 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-CREATE-URI"
 186 >gnome_vfs_create_uri</A
 187 >         (GnomeVFSHandle **handle,
 188                                              GnomeVFSURI *uri,
 189                                              <A
 190 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 191 >GnomeVFSOpenMode</A
 192 > open_mode,
 193                                              gboolean exclusive,
 194                                              guint perm);
 195 <A
 196 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 197 >GnomeVFSResult</A
 198 > <A
 199 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-CLOSE"
 200 >gnome_vfs_close</A
 201 >              (GnomeVFSHandle *handle);
 202 <A
 203 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 204 >GnomeVFSResult</A
 205 > <A
 206 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-READ"
 207 >gnome_vfs_read</A
 208 >               (GnomeVFSHandle *handle,
 209                                              gpointer buffer,
 210                                              <A
 211 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 212 >GnomeVFSFileSize</A
 213 > bytes,
 214                                              <A
 215 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 216 >GnomeVFSFileSize</A
 217 > *bytes_read);
 218 <A
 219 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 220 >GnomeVFSResult</A
 221 > <A
 222 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-WRITE"
 223 >gnome_vfs_write</A
 224 >              (GnomeVFSHandle *handle,
 225                                              gconstpointer buffer,
 226                                              <A
 227 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 228 >GnomeVFSFileSize</A
 229 > bytes,
 230                                              <A
 231 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 232 >GnomeVFSFileSize</A
 233 > *bytes_written);
 234 <A
 235 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 236 >GnomeVFSResult</A
 237 > <A
 238 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-SEEK"
 239 >gnome_vfs_seek</A
 240 >               (GnomeVFSHandle *handle,
 241                                              <A
 242 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSSEEKPOSITION"
 243 >GnomeVFSSeekPosition</A
 244 > whence,
 245                                              <A
 246 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILEOFFSET"
 247 >GnomeVFSFileOffset</A
 248 > offset);
 249 <A
 250 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 251 >GnomeVFSResult</A
 252 > <A
 253 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-TELL"
 254 >gnome_vfs_tell</A
 255 >               (GnomeVFSHandle *handle,
 256                                              <A
 257 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 258 >GnomeVFSFileSize</A
 259 > *offset_return);
 260 <A
 261 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 262 >GnomeVFSResult</A
 263 > <A
 264 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-GET-FILE-INFO"
 265 >gnome_vfs_get_file_info</A
 266 >      (const gchar *text_uri,
 267                                              <A
 268 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 269 >GnomeVFSFileInfo</A
 270 > *info,
 271                                              <A
 272 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 273 >GnomeVFSFileInfoOptions</A
 274 > options);
 275 <A
 276 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 277 >GnomeVFSResult</A
 278 > <A
 279 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-GET-FILE-INFO-URI"
 280 >gnome_vfs_get_file_info_uri</A
 281 >  (GnomeVFSURI *uri,
 282                                              <A
 283 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 284 >GnomeVFSFileInfo</A
 285 > *info,
 286                                              <A
 287 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 288 >GnomeVFSFileInfoOptions</A
 289 > options);
 290 <A
 291 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 292 >GnomeVFSResult</A
 293 > <A
 294 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-GET-FILE-INFO-FROM-HANDLE"
 295 >gnome_vfs_get_file_info_from_handle</A
 296 >
 297                                             (GnomeVFSHandle *handle,
 298                                              <A
 299 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 300 >GnomeVFSFileInfo</A
 301 > *info,
 302                                              <A
 303 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
 304 >GnomeVFSFileInfoOptions</A
 305 > options);
 306 <A
 307 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 308 >GnomeVFSResult</A
 309 > <A
 310 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-TRUNCATE"
 311 >gnome_vfs_truncate</A
 312 >           (const gchar *text_uri,
 313                                              <A
 314 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 315 >GnomeVFSFileSize</A
 316 > length);
 317 <A
 318 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 319 >GnomeVFSResult</A
 320 > <A
 321 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-TRUNCATE-URI"
 322 >gnome_vfs_truncate_uri</A
 323 >       (GnomeVFSURI *uri,
 324                                              <A
 325 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 326 >GnomeVFSFileSize</A
 327 > length);
 328 <A
 329 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 330 >GnomeVFSResult</A
 331 > <A
 332 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-TRUNCATE-HANDLE"
 333 >gnome_vfs_truncate_handle</A
 334 >    (GnomeVFSHandle *handle,
 335                                              <A
 336 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
 337 >GnomeVFSFileSize</A
 338 > length);
 339 <A
 340 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 341 >GnomeVFSResult</A
 342 > <A
 343 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-UNLINK-FROM-URI"
 344 >gnome_vfs_unlink_from_uri</A
 345 >    (GnomeVFSURI *uri);
 346 <A
 347 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 348 >GnomeVFSResult</A
 349 > <A
 350 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-CREATE-SYMBOLIC-LINK"
 351 >gnome_vfs_create_symbolic_link</A
 352 >
 353                                             (GnomeVFSURI *uri,
 354                                              const gchar *target_reference);
 355 <A
 356 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 357 >GnomeVFSResult</A
 358 > <A
 359 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-UNLINK"
 360 >gnome_vfs_unlink</A
 361 >             (const gchar *text_uri);
 362 <A
 363 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 364 >GnomeVFSResult</A
 365 > <A
 366 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-MOVE-URI"
 367 >gnome_vfs_move_uri</A
 368 >           (GnomeVFSURI *old_uri,
 369                                              GnomeVFSURI *new_uri,
 370                                              gboolean force_replace);
 371 <A
 372 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 373 >GnomeVFSResult</A
 374 > <A
 375 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-MOVE"
 376 >gnome_vfs_move</A
 377 >               (const gchar *old_text_uri,
 378                                              const gchar *new_text_uri,
 379                                              gboolean force_replace);
 380 <A
 381 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 382 >GnomeVFSResult</A
 383 > <A
 384 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-CHECK-SAME-FS-URIS"
 385 >gnome_vfs_check_same_fs_uris</A
 386 > (GnomeVFSURI *source_uri,
 387                                              GnomeVFSURI *target_uri,
 388                                              gboolean *same_fs_return);
 389 <A
 390 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 391 >GnomeVFSResult</A
 392 > <A
 393 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-CHECK-SAME-FS"
 394 >gnome_vfs_check_same_fs</A
 395 >      (const gchar *source,
 396                                              const gchar *target,
 397                                              gboolean *same_fs_return);
 398 gboolean    <A
 399 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-URI-EXISTS"
 400 >gnome_vfs_uri_exists</A
 401 >            (GnomeVFSURI *uri);
 402 <A
 403 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 404 >GnomeVFSResult</A
 405 > <A
 406 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-SET-FILE-INFO-URI"
 407 >gnome_vfs_set_file_info_uri</A
 408 >  (GnomeVFSURI *uri,
 409                                              <A
 410 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 411 >GnomeVFSFileInfo</A
 412 > *info,
 413                                              <A
 414 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSSETFILEINFOMASK"
 415 >GnomeVFSSetFileInfoMask</A
 416 > mask);
 417 <A
 418 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 419 >GnomeVFSResult</A
 420 > <A
 421 HREF="gnome-vfs-gnome-vfs-ops.html#GNOME-VFS-SET-FILE-INFO"
 422 >gnome_vfs_set_file_info</A
 423 >      (const gchar *text_uri,
 424                                              <A
 425 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
 426 >GnomeVFSFileInfo</A
 427 > *info,
 428                                              <A
 429 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSSETFILEINFOMASK"
 430 >GnomeVFSSetFileInfoMask</A
 431 > mask);
 432 typedef     <A
 433 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSMETHODHANDLE"
 434 >GnomeVFSMethodHandle</A
 435 >;
 436 enum        <A
 437 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 438 >GnomeVFSOpenMode</A
 439 >;
 440 enum        <A
 441 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSSEEKPOSITION"
 442 >GnomeVFSSeekPosition</A
 443 >;</PRE
 444 ></DIV
 445 ><DIV
 446 CLASS="REFSECT1"
 447 ><A
 448 NAME="AEN270"
 449 ></A
 450 ><H2
 451 >Description</H2
 452 ><P
 453 ></P
 454 ></DIV
 455 ><DIV
 456 CLASS="REFSECT1"
 457 ><A
 458 NAME="AEN273"
 459 ></A
 460 ><H2
 461 >Details</H2
 462 ><DIV
 463 CLASS="REFSECT2"
 464 ><A
 465 NAME="AEN275"
 466 ></A
 467 ><H3
 468 ><A
 469 NAME="GNOME-VFS-OPEN"
 470 ></A
 471 >gnome_vfs_open ()</H3
 472 ><PRE
 473 CLASS="PROGRAMLISTING"
 474 ><A
 475 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 476 >GnomeVFSResult</A
 477 > gnome_vfs_open               (GnomeVFSHandle **handle,
 478                                              const gchar *text_uri,
 479                                              <A
 480 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 481 >GnomeVFSOpenMode</A
 482 > open_mode);</PRE
 483 ><P
 484 >Open <TT
 485 CLASS="PARAMETER"
 486 ><I
 487 >text_uri</I
 488 ></TT
 489 > according to mode <TT
 490 CLASS="PARAMETER"
 491 ><I
 492 >open_mode</I
 493 ></TT
 494 >.  On return, <TT
 495 CLASS="PARAMETER"
 496 ><I
 497 >handle</I
 498 ></TT
 499 > will then
 500 contain a pointer to a handle for the open file.</P
 501 ><P
 502 ></P
 503 ><P
 504 ></P
 505 ><TABLE
 506 CLASS="variablelist"
 507 BORDER="0"
 508 CELLSPACING="0"
 509 CELLPADDING="4"
 510 ><TBODY
 511 ><TR
 512 ><TD
 513 ALIGN="LEFT"
 514 VALIGN="TOP"
 515 ><A
 516 NAME="AEN289"><SPAN
 517 STYLE="white-space: nowrap"
 518 ><TT
 519 CLASS="PARAMETER"
 520 ><I
 521 >handle</I
 522 ></TT
 523 >&nbsp;:</SPAN
 524 ></TD
 525 ><TD
 526 ALIGN="LEFT"
 527 VALIGN="TOP"
 528 ><P
 529 > A pointer to a pointer to a GnomeVFSHandle object</P
 530 ></TD
 531 ></TR
 532 ><TR
 533 ><TD
 534 ALIGN="LEFT"
 535 VALIGN="TOP"
 536 ><A
 537 NAME="AEN294"><SPAN
 538 STYLE="white-space: nowrap"
 539 ><TT
 540 CLASS="PARAMETER"
 541 ><I
 542 >text_uri</I
 543 ></TT
 544 >&nbsp;:</SPAN
 545 ></TD
 546 ><TD
 547 ALIGN="LEFT"
 548 VALIGN="TOP"
 549 ><P
 550 > String representing the URI to open</P
 551 ></TD
 552 ></TR
 553 ><TR
 554 ><TD
 555 ALIGN="LEFT"
 556 VALIGN="TOP"
 557 ><A
 558 NAME="AEN299"><SPAN
 559 STYLE="white-space: nowrap"
 560 ><TT
 561 CLASS="PARAMETER"
 562 ><I
 563 >open_mode</I
 564 ></TT
 565 >&nbsp;:</SPAN
 566 ></TD
 567 ><TD
 568 ALIGN="LEFT"
 569 VALIGN="TOP"
 570 ><P
 571 > Open mode</P
 572 ></TD
 573 ></TR
 574 ><TR
 575 ><TD
 576 ALIGN="LEFT"
 577 VALIGN="TOP"
 578 ><A
 579 NAME="AEN304"><SPAN
 580 STYLE="white-space: nowrap"
 581 ><SPAN
 582 CLASS="emphasis"
 583 ><I
 584 CLASS="EMPHASIS"
 585 >Returns</I
 586 ></SPAN
 587 > :</SPAN
 588 ></TD
 589 ><TD
 590 ALIGN="LEFT"
 591 VALIGN="TOP"
 592 ><P
 593 > An integer representing the result of the operation</P
 594 ></TD
 595 ></TR
 596 ></TBODY
 597 ></TABLE
 598 ></DIV
 599 ><HR><DIV
 600 CLASS="REFSECT2"
 601 ><A
 602 NAME="AEN309"
 603 ></A
 604 ><H3
 605 ><A
 606 NAME="GNOME-VFS-OPEN-URI"
 607 ></A
 608 >gnome_vfs_open_uri ()</H3
 609 ><PRE
 610 CLASS="PROGRAMLISTING"
 611 ><A
 612 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 613 >GnomeVFSResult</A
 614 > gnome_vfs_open_uri           (GnomeVFSHandle **handle,
 615                                              GnomeVFSURI *uri,
 616                                              <A
 617 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 618 >GnomeVFSOpenMode</A
 619 > open_mode);</PRE
 620 ><P
 621 >Open <TT
 622 CLASS="PARAMETER"
 623 ><I
 624 >uri</I
 625 ></TT
 626 > according to mode <TT
 627 CLASS="PARAMETER"
 628 ><I
 629 >open_mode</I
 630 ></TT
 631 >.  On return, <TT
 632 CLASS="PARAMETER"
 633 ><I
 634 >handle</I
 635 ></TT
 636 > will then
 637 contain a pointer to a handle for the open file.</P
 638 ><P
 639 ></P
 640 ><P
 641 ></P
 642 ><TABLE
 643 CLASS="variablelist"
 644 BORDER="0"
 645 CELLSPACING="0"
 646 CELLPADDING="4"
 647 ><TBODY
 648 ><TR
 649 ><TD
 650 ALIGN="LEFT"
 651 VALIGN="TOP"
 652 ><A
 653 NAME="AEN323"><SPAN
 654 STYLE="white-space: nowrap"
 655 ><TT
 656 CLASS="PARAMETER"
 657 ><I
 658 >handle</I
 659 ></TT
 660 >&nbsp;:</SPAN
 661 ></TD
 662 ><TD
 663 ALIGN="LEFT"
 664 VALIGN="TOP"
 665 ><P
 666 > A pointer to a pointer to a GnomeVFSHandle object</P
 667 ></TD
 668 ></TR
 669 ><TR
 670 ><TD
 671 ALIGN="LEFT"
 672 VALIGN="TOP"
 673 ><A
 674 NAME="AEN328"><SPAN
 675 STYLE="white-space: nowrap"
 676 ><TT
 677 CLASS="PARAMETER"
 678 ><I
 679 >uri</I
 680 ></TT
 681 >&nbsp;:</SPAN
 682 ></TD
 683 ><TD
 684 ALIGN="LEFT"
 685 VALIGN="TOP"
 686 ><P
 687 > URI to open</P
 688 ></TD
 689 ></TR
 690 ><TR
 691 ><TD
 692 ALIGN="LEFT"
 693 VALIGN="TOP"
 694 ><A
 695 NAME="AEN333"><SPAN
 696 STYLE="white-space: nowrap"
 697 ><TT
 698 CLASS="PARAMETER"
 699 ><I
 700 >open_mode</I
 701 ></TT
 702 >&nbsp;:</SPAN
 703 ></TD
 704 ><TD
 705 ALIGN="LEFT"
 706 VALIGN="TOP"
 707 ><P
 708 > Open mode</P
 709 ></TD
 710 ></TR
 711 ><TR
 712 ><TD
 713 ALIGN="LEFT"
 714 VALIGN="TOP"
 715 ><A
 716 NAME="AEN338"><SPAN
 717 STYLE="white-space: nowrap"
 718 ><SPAN
 719 CLASS="emphasis"
 720 ><I
 721 CLASS="EMPHASIS"
 722 >Returns</I
 723 ></SPAN
 724 > :</SPAN
 725 ></TD
 726 ><TD
 727 ALIGN="LEFT"
 728 VALIGN="TOP"
 729 ><P
 730 > An integer representing the result of the operation</P
 731 ></TD
 732 ></TR
 733 ></TBODY
 734 ></TABLE
 735 ></DIV
 736 ><HR><DIV
 737 CLASS="REFSECT2"
 738 ><A
 739 NAME="AEN343"
 740 ></A
 741 ><H3
 742 ><A
 743 NAME="GNOME-VFS-CREATE"
 744 ></A
 745 >gnome_vfs_create ()</H3
 746 ><PRE
 747 CLASS="PROGRAMLISTING"
 748 ><A
 749 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 750 >GnomeVFSResult</A
 751 > gnome_vfs_create             (GnomeVFSHandle **handle,
 752                                              const gchar *text_uri,
 753                                              <A
 754 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 755 >GnomeVFSOpenMode</A
 756 > open_mode,
 757                                              gboolean exclusive,
 758                                              guint perm);</PRE
 759 ><P
 760 >Create <TT
 761 CLASS="PARAMETER"
 762 ><I
 763 >uri</I
 764 ></TT
 765 > according to mode <TT
 766 CLASS="PARAMETER"
 767 ><I
 768 >open_mode</I
 769 ></TT
 770 >.  On return, <TT
 771 CLASS="PARAMETER"
 772 ><I
 773 >handle</I
 774 ></TT
 775 > will then
 776 contain a pointer to a handle for the open file.</P
 777 ><P
 778 ></P
 779 ><P
 780 ></P
 781 ><TABLE
 782 CLASS="variablelist"
 783 BORDER="0"
 784 CELLSPACING="0"
 785 CELLPADDING="4"
 786 ><TBODY
 787 ><TR
 788 ><TD
 789 ALIGN="LEFT"
 790 VALIGN="TOP"
 791 ><A
 792 NAME="AEN359"><SPAN
 793 STYLE="white-space: nowrap"
 794 ><TT
 795 CLASS="PARAMETER"
 796 ><I
 797 >handle</I
 798 ></TT
 799 >&nbsp;:</SPAN
 800 ></TD
 801 ><TD
 802 ALIGN="LEFT"
 803 VALIGN="TOP"
 804 ><P
 805 > A pointer to a pointer to a GnomeVFSHandle object</P
 806 ></TD
 807 ></TR
 808 ><TR
 809 ><TD
 810 ALIGN="LEFT"
 811 VALIGN="TOP"
 812 ><A
 813 NAME="AEN364"><SPAN
 814 STYLE="white-space: nowrap"
 815 ><TT
 816 CLASS="PARAMETER"
 817 ><I
 818 >text_uri</I
 819 ></TT
 820 >&nbsp;:</SPAN
 821 ></TD
 822 ><TD
 823 ALIGN="LEFT"
 824 VALIGN="TOP"
 825 ><P
 826 > String representing the URI to create</P
 827 ></TD
 828 ></TR
 829 ><TR
 830 ><TD
 831 ALIGN="LEFT"
 832 VALIGN="TOP"
 833 ><A
 834 NAME="AEN369"><SPAN
 835 STYLE="white-space: nowrap"
 836 ><TT
 837 CLASS="PARAMETER"
 838 ><I
 839 >open_mode</I
 840 ></TT
 841 >&nbsp;:</SPAN
 842 ></TD
 843 ><TD
 844 ALIGN="LEFT"
 845 VALIGN="TOP"
 846 ><P
 847 > mode to leave the file opened in after creation (or <TT
 848 CLASS="LITERAL"
 849 >GNOME_VFS_OPEN_MODE_NONE</TT
 850 >
 851 to leave the file closed after creation)</P
 852 ></TD
 853 ></TR
 854 ><TR
 855 ><TD
 856 ALIGN="LEFT"
 857 VALIGN="TOP"
 858 ><A
 859 NAME="AEN375"><SPAN
 860 STYLE="white-space: nowrap"
 861 ><TT
 862 CLASS="PARAMETER"
 863 ><I
 864 >exclusive</I
 865 ></TT
 866 >&nbsp;:</SPAN
 867 ></TD
 868 ><TD
 869 ALIGN="LEFT"
 870 VALIGN="TOP"
 871 ><P
 872 > Whether the file should be created in "exclusive" mode:
 873 i.e. if this flag is nonzero, operation will fail if a file with the
 874 same name already exists.</P
 875 ></TD
 876 ></TR
 877 ><TR
 878 ><TD
 879 ALIGN="LEFT"
 880 VALIGN="TOP"
 881 ><A
 882 NAME="AEN380"><SPAN
 883 STYLE="white-space: nowrap"
 884 ><TT
 885 CLASS="PARAMETER"
 886 ><I
 887 >perm</I
 888 ></TT
 889 >&nbsp;:</SPAN
 890 ></TD
 891 ><TD
 892 ALIGN="LEFT"
 893 VALIGN="TOP"
 894 ><P
 895 > Bitmap representing the permissions for the newly created file
 896 (Unix style).</P
 897 ></TD
 898 ></TR
 899 ><TR
 900 ><TD
 901 ALIGN="LEFT"
 902 VALIGN="TOP"
 903 ><A
 904 NAME="AEN385"><SPAN
 905 STYLE="white-space: nowrap"
 906 ><SPAN
 907 CLASS="emphasis"
 908 ><I
 909 CLASS="EMPHASIS"
 910 >Returns</I
 911 ></SPAN
 912 > :</SPAN
 913 ></TD
 914 ><TD
 915 ALIGN="LEFT"
 916 VALIGN="TOP"
 917 ><P
 918 > An integer representing the result of the operation</P
 919 ></TD
 920 ></TR
 921 ></TBODY
 922 ></TABLE
 923 ></DIV
 924 ><HR><DIV
 925 CLASS="REFSECT2"
 926 ><A
 927 NAME="AEN390"
 928 ></A
 929 ><H3
 930 ><A
 931 NAME="GNOME-VFS-CREATE-URI"
 932 ></A
 933 >gnome_vfs_create_uri ()</H3
 934 ><PRE
 935 CLASS="PROGRAMLISTING"
 936 ><A
 937 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
 938 >GnomeVFSResult</A
 939 > gnome_vfs_create_uri         (GnomeVFSHandle **handle,
 940                                              GnomeVFSURI *uri,
 941                                              <A
 942 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSOPENMODE"
 943 >GnomeVFSOpenMode</A
 944 > open_mode,
 945                                              gboolean exclusive,
 946                                              guint perm);</PRE
 947 ><P
 948 >Create <TT
 949 CLASS="PARAMETER"
 950 ><I
 951 >uri</I
 952 ></TT
 953 > according to mode <TT
 954 CLASS="PARAMETER"
 955 ><I
 956 >open_mode</I
 957 ></TT
 958 >.  On return, <TT
 959 CLASS="PARAMETER"
 960 ><I
 961 >handle</I
 962 ></TT
 963 > will then
 964 contain a pointer to a handle for the open file.</P
 965 ><P
 966 ></P
 967 ><P
 968 ></P
 969 ><TABLE
 970 CLASS="variablelist"
 971 BORDER="0"
 972 CELLSPACING="0"
 973 CELLPADDING="4"
 974 ><TBODY
 975 ><TR
 976 ><TD
 977 ALIGN="LEFT"
 978 VALIGN="TOP"
 979 ><A
 980 NAME="AEN406"><SPAN
 981 STYLE="white-space: nowrap"
 982 ><TT
 983 CLASS="PARAMETER"
 984 ><I
 985 >handle</I
 986 ></TT
 987 >&nbsp;:</SPAN
 988 ></TD
 989 ><TD
 990 ALIGN="LEFT"
 991 VALIGN="TOP"
 992 ><P
 993 > A pointer to a pointer to a GnomeVFSHandle object</P
 994 ></TD
 995 ></TR
 996 ><TR
 997 ><TD
 998 ALIGN="LEFT"
 999 VALIGN="TOP"
1000 ><A
1001 NAME="AEN411"><SPAN
1002 STYLE="white-space: nowrap"
1003 ><TT
1004 CLASS="PARAMETER"
1005 ><I
1006 >uri</I
1007 ></TT
1008 >&nbsp;:</SPAN
1009 ></TD
1010 ><TD
1011 ALIGN="LEFT"
1012 VALIGN="TOP"
1013 ><P
1014 > URI for the file to create</P
1015 ></TD
1016 ></TR
1017 ><TR
1018 ><TD
1019 ALIGN="LEFT"
1020 VALIGN="TOP"
1021 ><A
1022 NAME="AEN416"><SPAN
1023 STYLE="white-space: nowrap"
1024 ><TT
1025 CLASS="PARAMETER"
1026 ><I
1027 >open_mode</I
1028 ></TT
1029 >&nbsp;:</SPAN
1030 ></TD
1031 ><TD
1032 ALIGN="LEFT"
1033 VALIGN="TOP"
1034 ><P
1035 > Open mode</P
1036 ></TD
1037 ></TR
1038 ><TR
1039 ><TD
1040 ALIGN="LEFT"
1041 VALIGN="TOP"
1042 ><A
1043 NAME="AEN421"><SPAN
1044 STYLE="white-space: nowrap"
1045 ><TT
1046 CLASS="PARAMETER"
1047 ><I
1048 >exclusive</I
1049 ></TT
1050 >&nbsp;:</SPAN
1051 ></TD
1052 ><TD
1053 ALIGN="LEFT"
1054 VALIGN="TOP"
1055 ><P
1056 > Whether the file should be created in "exclusive" mode:
1057 i.e. if this flag is nonzero, operation will fail if a file with the
1058 same name already exists.</P
1059 ></TD
1060 ></TR
1061 ><TR
1062 ><TD
1063 ALIGN="LEFT"
1064 VALIGN="TOP"
1065 ><A
1066 NAME="AEN426"><SPAN
1067 STYLE="white-space: nowrap"
1068 ><TT
1069 CLASS="PARAMETER"
1070 ><I
1071 >perm</I
1072 ></TT
1073 >&nbsp;:</SPAN
1074 ></TD
1075 ><TD
1076 ALIGN="LEFT"
1077 VALIGN="TOP"
1078 ><P
1079 > Bitmap representing the permissions for the newly created file
1080 (Unix style).</P
1081 ></TD
1082 ></TR
1083 ><TR
1084 ><TD
1085 ALIGN="LEFT"
1086 VALIGN="TOP"
1087 ><A
1088 NAME="AEN431"><SPAN
1089 STYLE="white-space: nowrap"
1090 ><SPAN
1091 CLASS="emphasis"
1092 ><I
1093 CLASS="EMPHASIS"
1094 >Returns</I
1095 ></SPAN
1096 > :</SPAN
1097 ></TD
1098 ><TD
1099 ALIGN="LEFT"
1100 VALIGN="TOP"
1101 ><P
1102 > An integer representing the result of the operation</P
1103 ></TD
1104 ></TR
1105 ></TBODY
1106 ></TABLE
1107 ></DIV
1108 ><HR><DIV
1109 CLASS="REFSECT2"
1110 ><A
1111 NAME="AEN436"
1112 ></A
1113 ><H3
1114 ><A
1115 NAME="GNOME-VFS-CLOSE"
1116 ></A
1117 >gnome_vfs_close ()</H3
1118 ><PRE
1119 CLASS="PROGRAMLISTING"
1120 ><A
1121 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1122 >GnomeVFSResult</A
1123 > gnome_vfs_close              (GnomeVFSHandle *handle);</PRE
1124 ><P
1125 >Close file associated with <TT
1126 CLASS="PARAMETER"
1127 ><I
1128 >handle</I
1129 ></TT
1130 >.</P
1131 ><P
1132 ></P
1133 ><P
1134 ></P
1135 ><TABLE
1136 CLASS="variablelist"
1137 BORDER="0"
1138 CELLSPACING="0"
1139 CELLPADDING="4"
1140 ><TBODY
1141 ><TR
1142 ><TD
1143 ALIGN="LEFT"
1144 VALIGN="TOP"
1145 ><A
1146 NAME="AEN446"><SPAN
1147 STYLE="white-space: nowrap"
1148 ><TT
1149 CLASS="PARAMETER"
1150 ><I
1151 >handle</I
1152 ></TT
1153 >&nbsp;:</SPAN
1154 ></TD
1155 ><TD
1156 ALIGN="LEFT"
1157 VALIGN="TOP"
1158 ><P
1159 > A pointer to a GnomeVFSHandle object</P
1160 ></TD
1161 ></TR
1162 ><TR
1163 ><TD
1164 ALIGN="LEFT"
1165 VALIGN="TOP"
1166 ><A
1167 NAME="AEN451"><SPAN
1168 STYLE="white-space: nowrap"
1169 ><SPAN
1170 CLASS="emphasis"
1171 ><I
1172 CLASS="EMPHASIS"
1173 >Returns</I
1174 ></SPAN
1175 > :</SPAN
1176 ></TD
1177 ><TD
1178 ALIGN="LEFT"
1179 VALIGN="TOP"
1180 ><P
1181 > An integer representing the result of the operation.</P
1182 ></TD
1183 ></TR
1184 ></TBODY
1185 ></TABLE
1186 ></DIV
1187 ><HR><DIV
1188 CLASS="REFSECT2"
1189 ><A
1190 NAME="AEN456"
1191 ></A
1192 ><H3
1193 ><A
1194 NAME="GNOME-VFS-READ"
1195 ></A
1196 >gnome_vfs_read ()</H3
1197 ><PRE
1198 CLASS="PROGRAMLISTING"
1199 ><A
1200 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1201 >GnomeVFSResult</A
1202 > gnome_vfs_read               (GnomeVFSHandle *handle,
1203                                              gpointer buffer,
1204                                              <A
1205 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1206 >GnomeVFSFileSize</A
1207 > bytes,
1208                                              <A
1209 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1210 >GnomeVFSFileSize</A
1211 > *bytes_read);</PRE
1212 ><P
1213 >Read <TT
1214 CLASS="PARAMETER"
1215 ><I
1216 >bytes</I
1217 ></TT
1218 > from <TT
1219 CLASS="PARAMETER"
1220 ><I
1221 >handle</I
1222 ></TT
1223 >.  As with Unix system calls, the number of
1224 bytes read can effectively be less than <TT
1225 CLASS="PARAMETER"
1226 ><I
1227 >bytes</I
1228 ></TT
1229 > on return and will be
1230 stored in <TT
1231 CLASS="PARAMETER"
1232 ><I
1233 >bytes_read</I
1234 ></TT
1235 >.</P
1236 ><P
1237 ></P
1238 ><P
1239 ></P
1240 ><TABLE
1241 CLASS="variablelist"
1242 BORDER="0"
1243 CELLSPACING="0"
1244 CELLPADDING="4"
1245 ><TBODY
1246 ><TR
1247 ><TD
1248 ALIGN="LEFT"
1249 VALIGN="TOP"
1250 ><A
1251 NAME="AEN472"><SPAN
1252 STYLE="white-space: nowrap"
1253 ><TT
1254 CLASS="PARAMETER"
1255 ><I
1256 >handle</I
1257 ></TT
1258 >&nbsp;:</SPAN
1259 ></TD
1260 ><TD
1261 ALIGN="LEFT"
1262 VALIGN="TOP"
1263 ><P
1264 > Handle of the file to read data from</P
1265 ></TD
1266 ></TR
1267 ><TR
1268 ><TD
1269 ALIGN="LEFT"
1270 VALIGN="TOP"
1271 ><A
1272 NAME="AEN477"><SPAN
1273 STYLE="white-space: nowrap"
1274 ><TT
1275 CLASS="PARAMETER"
1276 ><I
1277 >buffer</I
1278 ></TT
1279 >&nbsp;:</SPAN
1280 ></TD
1281 ><TD
1282 ALIGN="LEFT"
1283 VALIGN="TOP"
1284 ><P
1285 > Pointer to a buffer that must be at least <TT
1286 CLASS="PARAMETER"
1287 ><I
1288 >bytes</I
1289 ></TT
1290 > bytes large</P
1291 ></TD
1292 ></TR
1293 ><TR
1294 ><TD
1295 ALIGN="LEFT"
1296 VALIGN="TOP"
1297 ><A
1298 NAME="AEN483"><SPAN
1299 STYLE="white-space: nowrap"
1300 ><TT
1301 CLASS="PARAMETER"
1302 ><I
1303 >bytes</I
1304 ></TT
1305 >&nbsp;:</SPAN
1306 ></TD
1307 ><TD
1308 ALIGN="LEFT"
1309 VALIGN="TOP"
1310 ><P
1311 > Number of bytes to read</P
1312 ></TD
1313 ></TR
1314 ><TR
1315 ><TD
1316 ALIGN="LEFT"
1317 VALIGN="TOP"
1318 ><A
1319 NAME="AEN488"><SPAN
1320 STYLE="white-space: nowrap"
1321 ><TT
1322 CLASS="PARAMETER"
1323 ><I
1324 >bytes_read</I
1325 ></TT
1326 >&nbsp;:</SPAN
1327 ></TD
1328 ><TD
1329 ALIGN="LEFT"
1330 VALIGN="TOP"
1331 ><P
1332 > Pointer to a variable that will hold the number of bytes
1333 effectively read on return.</P
1334 ></TD
1335 ></TR
1336 ><TR
1337 ><TD
1338 ALIGN="LEFT"
1339 VALIGN="TOP"
1340 ><A
1341 NAME="AEN493"><SPAN
1342 STYLE="white-space: nowrap"
1343 ><SPAN
1344 CLASS="emphasis"
1345 ><I
1346 CLASS="EMPHASIS"
1347 >Returns</I
1348 ></SPAN
1349 > :</SPAN
1350 ></TD
1351 ><TD
1352 ALIGN="LEFT"
1353 VALIGN="TOP"
1354 ><P
1355 > An integer representing the result of the operation</P
1356 ></TD
1357 ></TR
1358 ></TBODY
1359 ></TABLE
1360 ></DIV
1361 ><HR><DIV
1362 CLASS="REFSECT2"
1363 ><A
1364 NAME="AEN498"
1365 ></A
1366 ><H3
1367 ><A
1368 NAME="GNOME-VFS-WRITE"
1369 ></A
1370 >gnome_vfs_write ()</H3
1371 ><PRE
1372 CLASS="PROGRAMLISTING"
1373 ><A
1374 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1375 >GnomeVFSResult</A
1376 > gnome_vfs_write              (GnomeVFSHandle *handle,
1377                                              gconstpointer buffer,
1378                                              <A
1379 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1380 >GnomeVFSFileSize</A
1381 > bytes,
1382                                              <A
1383 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1384 >GnomeVFSFileSize</A
1385 > *bytes_written);</PRE
1386 ><P
1387 >Write <TT
1388 CLASS="PARAMETER"
1389 ><I
1390 >bytes</I
1391 ></TT
1392 > into the file opened through <TT
1393 CLASS="PARAMETER"
1394 ><I
1395 >handle</I
1396 ></TT
1397 >.  As with Unix system
1398 calls, the number of bytes written can effectively be less than <TT
1399 CLASS="PARAMETER"
1400 ><I
1401 >bytes</I
1402 ></TT
1403 > on
1404 return and will be stored in <TT
1405 CLASS="PARAMETER"
1406 ><I
1407 >bytes_written</I
1408 ></TT
1409 >.</P
1410 ><P
1411 ></P
1412 ><P
1413 ></P
1414 ><TABLE
1415 CLASS="variablelist"
1416 BORDER="0"
1417 CELLSPACING="0"
1418 CELLPADDING="4"
1419 ><TBODY
1420 ><TR
1421 ><TD
1422 ALIGN="LEFT"
1423 VALIGN="TOP"
1424 ><A
1425 NAME="AEN514"><SPAN
1426 STYLE="white-space: nowrap"
1427 ><TT
1428 CLASS="PARAMETER"
1429 ><I
1430 >handle</I
1431 ></TT
1432 >&nbsp;:</SPAN
1433 ></TD
1434 ><TD
1435 ALIGN="LEFT"
1436 VALIGN="TOP"
1437 ><P
1438 > Handle of the file to write data to</P
1439 ></TD
1440 ></TR
1441 ><TR
1442 ><TD
1443 ALIGN="LEFT"
1444 VALIGN="TOP"
1445 ><A
1446 NAME="AEN519"><SPAN
1447 STYLE="white-space: nowrap"
1448 ><TT
1449 CLASS="PARAMETER"
1450 ><I
1451 >buffer</I
1452 ></TT
1453 >&nbsp;:</SPAN
1454 ></TD
1455 ><TD
1456 ALIGN="LEFT"
1457 VALIGN="TOP"
1458 ><P
1459 > Pointer to the buffer containing the data to be written</P
1460 ></TD
1461 ></TR
1462 ><TR
1463 ><TD
1464 ALIGN="LEFT"
1465 VALIGN="TOP"
1466 ><A
1467 NAME="AEN524"><SPAN
1468 STYLE="white-space: nowrap"
1469 ><TT
1470 CLASS="PARAMETER"
1471 ><I
1472 >bytes</I
1473 ></TT
1474 >&nbsp;:</SPAN
1475 ></TD
1476 ><TD
1477 ALIGN="LEFT"
1478 VALIGN="TOP"
1479 ><P
1480 > Number of bytes to write</P
1481 ></TD
1482 ></TR
1483 ><TR
1484 ><TD
1485 ALIGN="LEFT"
1486 VALIGN="TOP"
1487 ><A
1488 NAME="AEN529"><SPAN
1489 STYLE="white-space: nowrap"
1490 ><TT
1491 CLASS="PARAMETER"
1492 ><I
1493 >bytes_written</I
1494 ></TT
1495 >&nbsp;:</SPAN
1496 ></TD
1497 ><TD
1498 ALIGN="LEFT"
1499 VALIGN="TOP"
1500 ><P
1501 > Pointer to a variable that will hold the number of bytes
1502 effectively written on return.</P
1503 ></TD
1504 ></TR
1505 ><TR
1506 ><TD
1507 ALIGN="LEFT"
1508 VALIGN="TOP"
1509 ><A
1510 NAME="AEN534"><SPAN
1511 STYLE="white-space: nowrap"
1512 ><SPAN
1513 CLASS="emphasis"
1514 ><I
1515 CLASS="EMPHASIS"
1516 >Returns</I
1517 ></SPAN
1518 > :</SPAN
1519 ></TD
1520 ><TD
1521 ALIGN="LEFT"
1522 VALIGN="TOP"
1523 ><P
1524 > An integer representing the result of the operation</P
1525 ></TD
1526 ></TR
1527 ></TBODY
1528 ></TABLE
1529 ></DIV
1530 ><HR><DIV
1531 CLASS="REFSECT2"
1532 ><A
1533 NAME="AEN539"
1534 ></A
1535 ><H3
1536 ><A
1537 NAME="GNOME-VFS-SEEK"
1538 ></A
1539 >gnome_vfs_seek ()</H3
1540 ><PRE
1541 CLASS="PROGRAMLISTING"
1542 ><A
1543 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1544 >GnomeVFSResult</A
1545 > gnome_vfs_seek               (GnomeVFSHandle *handle,
1546                                              <A
1547 HREF="gnome-vfs-gnome-vfs-ops.html#GNOMEVFSSEEKPOSITION"
1548 >GnomeVFSSeekPosition</A
1549 > whence,
1550                                              <A
1551 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILEOFFSET"
1552 >GnomeVFSFileOffset</A
1553 > offset);</PRE
1554 ><P
1555 >Set the current position for reading/writing through <TT
1556 CLASS="PARAMETER"
1557 ><I
1558 >handle</I
1559 ></TT
1560 >.</P
1561 ><P
1562 ></P
1563 ><P
1564 ></P
1565 ><TABLE
1566 CLASS="variablelist"
1567 BORDER="0"
1568 CELLSPACING="0"
1569 CELLPADDING="4"
1570 ><TBODY
1571 ><TR
1572 ><TD
1573 ALIGN="LEFT"
1574 VALIGN="TOP"
1575 ><A
1576 NAME="AEN551"><SPAN
1577 STYLE="white-space: nowrap"
1578 ><TT
1579 CLASS="PARAMETER"
1580 ><I
1581 >handle</I
1582 ></TT
1583 >&nbsp;:</SPAN
1584 ></TD
1585 ><TD
1586 ALIGN="LEFT"
1587 VALIGN="TOP"
1588 ><P
1589 > Handle for which the current position must be changed</P
1590 ></TD
1591 ></TR
1592 ><TR
1593 ><TD
1594 ALIGN="LEFT"
1595 VALIGN="TOP"
1596 ><A
1597 NAME="AEN556"><SPAN
1598 STYLE="white-space: nowrap"
1599 ><TT
1600 CLASS="PARAMETER"
1601 ><I
1602 >whence</I
1603 ></TT
1604 >&nbsp;:</SPAN
1605 ></TD
1606 ><TD
1607 ALIGN="LEFT"
1608 VALIGN="TOP"
1609 ><P
1610 > Integer value representing the starting position</P
1611 ></TD
1612 ></TR
1613 ><TR
1614 ><TD
1615 ALIGN="LEFT"
1616 VALIGN="TOP"
1617 ><A
1618 NAME="AEN561"><SPAN
1619 STYLE="white-space: nowrap"
1620 ><TT
1621 CLASS="PARAMETER"
1622 ><I
1623 >offset</I
1624 ></TT
1625 >&nbsp;:</SPAN
1626 ></TD
1627 ><TD
1628 ALIGN="LEFT"
1629 VALIGN="TOP"
1630 ><P
1631 > Number of bytes to skip from the position specified by <TT
1632 CLASS="PARAMETER"
1633 ><I
1634 >whence</I
1635 ></TT
1636 >
1637 (a positive value means to move forward; a negative one to move backwards)</P
1638 ></TD
1639 ></TR
1640 ><TR
1641 ><TD
1642 ALIGN="LEFT"
1643 VALIGN="TOP"
1644 ><A
1645 NAME="AEN567"><SPAN
1646 STYLE="white-space: nowrap"
1647 ><SPAN
1648 CLASS="emphasis"
1649 ><I
1650 CLASS="EMPHASIS"
1651 >Returns</I
1652 ></SPAN
1653 > :</SPAN
1654 ></TD
1655 ><TD
1656 ALIGN="LEFT"
1657 VALIGN="TOP"
1658 ><P
1659 > </P
1660 ></TD
1661 ></TR
1662 ></TBODY
1663 ></TABLE
1664 ></DIV
1665 ><HR><DIV
1666 CLASS="REFSECT2"
1667 ><A
1668 NAME="AEN572"
1669 ></A
1670 ><H3
1671 ><A
1672 NAME="GNOME-VFS-TELL"
1673 ></A
1674 >gnome_vfs_tell ()</H3
1675 ><PRE
1676 CLASS="PROGRAMLISTING"
1677 ><A
1678 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1679 >GnomeVFSResult</A
1680 > gnome_vfs_tell               (GnomeVFSHandle *handle,
1681                                              <A
1682 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1683 >GnomeVFSFileSize</A
1684 > *offset_return);</PRE
1685 ><P
1686 >Return the current position on <TT
1687 CLASS="PARAMETER"
1688 ><I
1689 >handle</I
1690 ></TT
1691 >. This is the point in the file
1692 pointed to by handle that reads and writes will occur on.</P
1693 ><P
1694 ></P
1695 ><P
1696 ></P
1697 ><TABLE
1698 CLASS="variablelist"
1699 BORDER="0"
1700 CELLSPACING="0"
1701 CELLPADDING="4"
1702 ><TBODY
1703 ><TR
1704 ><TD
1705 ALIGN="LEFT"
1706 VALIGN="TOP"
1707 ><A
1708 NAME="AEN583"><SPAN
1709 STYLE="white-space: nowrap"
1710 ><TT
1711 CLASS="PARAMETER"
1712 ><I
1713 >handle</I
1714 ></TT
1715 >&nbsp;:</SPAN
1716 ></TD
1717 ><TD
1718 ALIGN="LEFT"
1719 VALIGN="TOP"
1720 ><P
1721 > Handle for which the current position must be retrieved</P
1722 ></TD
1723 ></TR
1724 ><TR
1725 ><TD
1726 ALIGN="LEFT"
1727 VALIGN="TOP"
1728 ><A
1729 NAME="AEN588"><SPAN
1730 STYLE="white-space: nowrap"
1731 ><TT
1732 CLASS="PARAMETER"
1733 ><I
1734 >offset_return</I
1735 ></TT
1736 >&nbsp;:</SPAN
1737 ></TD
1738 ><TD
1739 ALIGN="LEFT"
1740 VALIGN="TOP"
1741 ><P
1742 > Pointer to a variable that will contain the current position
1743 on return</P
1744 ></TD
1745 ></TR
1746 ><TR
1747 ><TD
1748 ALIGN="LEFT"
1749 VALIGN="TOP"
1750 ><A
1751 NAME="AEN593"><SPAN
1752 STYLE="white-space: nowrap"
1753 ><SPAN
1754 CLASS="emphasis"
1755 ><I
1756 CLASS="EMPHASIS"
1757 >Returns</I
1758 ></SPAN
1759 > :</SPAN
1760 ></TD
1761 ><TD
1762 ALIGN="LEFT"
1763 VALIGN="TOP"
1764 ><P
1765 > An integer representing the result of the operation</P
1766 ></TD
1767 ></TR
1768 ></TBODY
1769 ></TABLE
1770 ></DIV
1771 ><HR><DIV
1772 CLASS="REFSECT2"
1773 ><A
1774 NAME="AEN598"
1775 ></A
1776 ><H3
1777 ><A
1778 NAME="GNOME-VFS-GET-FILE-INFO"
1779 ></A
1780 >gnome_vfs_get_file_info ()</H3
1781 ><PRE
1782 CLASS="PROGRAMLISTING"
1783 ><A
1784 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1785 >GnomeVFSResult</A
1786 > gnome_vfs_get_file_info      (const gchar *text_uri,
1787                                              <A
1788 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
1789 >GnomeVFSFileInfo</A
1790 > *info,
1791                                              <A
1792 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
1793 >GnomeVFSFileInfoOptions</A
1794 > options);</PRE
1795 ><P
1796 >Retrieve information about <TT
1797 CLASS="PARAMETER"
1798 ><I
1799 >text_uri</I
1800 ></TT
1801 >.  The information will be stored in
1802 <TT
1803 CLASS="PARAMETER"
1804 ><I
1805 >info</I
1806 ></TT
1807 >.</P
1808 ><P
1809 ></P
1810 ><P
1811 ></P
1812 ><TABLE
1813 CLASS="variablelist"
1814 BORDER="0"
1815 CELLSPACING="0"
1816 CELLPADDING="4"
1817 ><TBODY
1818 ><TR
1819 ><TD
1820 ALIGN="LEFT"
1821 VALIGN="TOP"
1822 ><A
1823 NAME="AEN611"><SPAN
1824 STYLE="white-space: nowrap"
1825 ><TT
1826 CLASS="PARAMETER"
1827 ><I
1828 >text_uri</I
1829 ></TT
1830 >&nbsp;:</SPAN
1831 ></TD
1832 ><TD
1833 ALIGN="LEFT"
1834 VALIGN="TOP"
1835 ><P
1836 > URI of the file for which information will be retrieved</P
1837 ></TD
1838 ></TR
1839 ><TR
1840 ><TD
1841 ALIGN="LEFT"
1842 VALIGN="TOP"
1843 ><A
1844 NAME="AEN616"><SPAN
1845 STYLE="white-space: nowrap"
1846 ><TT
1847 CLASS="PARAMETER"
1848 ><I
1849 >info</I
1850 ></TT
1851 >&nbsp;:</SPAN
1852 ></TD
1853 ><TD
1854 ALIGN="LEFT"
1855 VALIGN="TOP"
1856 ><P
1857 > Pointer to a GnomeVFSFileInfo object that will hold the information
1858 for the file on return</P
1859 ></TD
1860 ></TR
1861 ><TR
1862 ><TD
1863 ALIGN="LEFT"
1864 VALIGN="TOP"
1865 ><A
1866 NAME="AEN621"><SPAN
1867 STYLE="white-space: nowrap"
1868 ><TT
1869 CLASS="PARAMETER"
1870 ><I
1871 >options</I
1872 ></TT
1873 >&nbsp;:</SPAN
1874 ></TD
1875 ><TD
1876 ALIGN="LEFT"
1877 VALIGN="TOP"
1878 ><P
1879 > Options for retrieving file information
1880 to retrieve for the file</P
1881 ></TD
1882 ></TR
1883 ><TR
1884 ><TD
1885 ALIGN="LEFT"
1886 VALIGN="TOP"
1887 ><A
1888 NAME="AEN626"><SPAN
1889 STYLE="white-space: nowrap"
1890 ><SPAN
1891 CLASS="emphasis"
1892 ><I
1893 CLASS="EMPHASIS"
1894 >Returns</I
1895 ></SPAN
1896 > :</SPAN
1897 ></TD
1898 ><TD
1899 ALIGN="LEFT"
1900 VALIGN="TOP"
1901 ><P
1902 > An integer representing the result of the operation</P
1903 ></TD
1904 ></TR
1905 ></TBODY
1906 ></TABLE
1907 ></DIV
1908 ><HR><DIV
1909 CLASS="REFSECT2"
1910 ><A
1911 NAME="AEN631"
1912 ></A
1913 ><H3
1914 ><A
1915 NAME="GNOME-VFS-GET-FILE-INFO-URI"
1916 ></A
1917 >gnome_vfs_get_file_info_uri ()</H3
1918 ><PRE
1919 CLASS="PROGRAMLISTING"
1920 ><A
1921 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
1922 >GnomeVFSResult</A
1923 > gnome_vfs_get_file_info_uri  (GnomeVFSURI *uri,
1924                                              <A
1925 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
1926 >GnomeVFSFileInfo</A
1927 > *info,
1928                                              <A
1929 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
1930 >GnomeVFSFileInfoOptions</A
1931 > options);</PRE
1932 ><P
1933 >Retrieve information about <TT
1934 CLASS="PARAMETER"
1935 ><I
1936 >text_uri</I
1937 ></TT
1938 >.  The information will be stored in
1939 <TT
1940 CLASS="PARAMETER"
1941 ><I
1942 >info</I
1943 ></TT
1944 >.</P
1945 ><P
1946 ></P
1947 ><P
1948 ></P
1949 ><TABLE
1950 CLASS="variablelist"
1951 BORDER="0"
1952 CELLSPACING="0"
1953 CELLPADDING="4"
1954 ><TBODY
1955 ><TR
1956 ><TD
1957 ALIGN="LEFT"
1958 VALIGN="TOP"
1959 ><A
1960 NAME="AEN644"><SPAN
1961 STYLE="white-space: nowrap"
1962 ><TT
1963 CLASS="PARAMETER"
1964 ><I
1965 >uri</I
1966 ></TT
1967 >&nbsp;:</SPAN
1968 ></TD
1969 ><TD
1970 ALIGN="LEFT"
1971 VALIGN="TOP"
1972 ><P
1973 > URI of the file for which information will be retrieved</P
1974 ></TD
1975 ></TR
1976 ><TR
1977 ><TD
1978 ALIGN="LEFT"
1979 VALIGN="TOP"
1980 ><A
1981 NAME="AEN649"><SPAN
1982 STYLE="white-space: nowrap"
1983 ><TT
1984 CLASS="PARAMETER"
1985 ><I
1986 >info</I
1987 ></TT
1988 >&nbsp;:</SPAN
1989 ></TD
1990 ><TD
1991 ALIGN="LEFT"
1992 VALIGN="TOP"
1993 ><P
1994 > Pointer to a GnomeVFSFileInfo object that will hold the information
1995 for the file on return</P
1996 ></TD
1997 ></TR
1998 ><TR
1999 ><TD
2000 ALIGN="LEFT"
2001 VALIGN="TOP"
2002 ><A
2003 NAME="AEN654"><SPAN
2004 STYLE="white-space: nowrap"
2005 ><TT
2006 CLASS="PARAMETER"
2007 ><I
2008 >options</I
2009 ></TT
2010 >&nbsp;:</SPAN
2011 ></TD
2012 ><TD
2013 ALIGN="LEFT"
2014 VALIGN="TOP"
2015 ><P
2016 > Options for retrieving file information
2017 to retrieve for the file</P
2018 ></TD
2019 ></TR
2020 ><TR
2021 ><TD
2022 ALIGN="LEFT"
2023 VALIGN="TOP"
2024 ><A
2025 NAME="AEN659"><SPAN
2026 STYLE="white-space: nowrap"
2027 ><SPAN
2028 CLASS="emphasis"
2029 ><I
2030 CLASS="EMPHASIS"
2031 >Returns</I
2032 ></SPAN
2033 > :</SPAN
2034 ></TD
2035 ><TD
2036 ALIGN="LEFT"
2037 VALIGN="TOP"
2038 ><P
2039 > An integer representing the result of the operation</P
2040 ></TD
2041 ></TR
2042 ></TBODY
2043 ></TABLE
2044 ></DIV
2045 ><HR><DIV
2046 CLASS="REFSECT2"
2047 ><A
2048 NAME="AEN664"
2049 ></A
2050 ><H3
2051 ><A
2052 NAME="GNOME-VFS-GET-FILE-INFO-FROM-HANDLE"
2053 ></A
2054 >gnome_vfs_get_file_info_from_handle ()</H3
2055 ><PRE
2056 CLASS="PROGRAMLISTING"
2057 ><A
2058 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2059 >GnomeVFSResult</A
2060 > gnome_vfs_get_file_info_from_handle
2061                                             (GnomeVFSHandle *handle,
2062                                              <A
2063 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
2064 >GnomeVFSFileInfo</A
2065 > *info,
2066                                              <A
2067 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFOOPTIONS"
2068 >GnomeVFSFileInfoOptions</A
2069 > options);</PRE
2070 ><P
2071 >Retrieve information about an open file.  The information will be stored in
2072 <TT
2073 CLASS="PARAMETER"
2074 ><I
2075 >info</I
2076 ></TT
2077 >.</P
2078 ><P
2079 ></P
2080 ><P
2081 ></P
2082 ><TABLE
2083 CLASS="variablelist"
2084 BORDER="0"
2085 CELLSPACING="0"
2086 CELLPADDING="4"
2087 ><TBODY
2088 ><TR
2089 ><TD
2090 ALIGN="LEFT"
2091 VALIGN="TOP"
2092 ><A
2093 NAME="AEN676"><SPAN
2094 STYLE="white-space: nowrap"
2095 ><TT
2096 CLASS="PARAMETER"
2097 ><I
2098 >handle</I
2099 ></TT
2100 >&nbsp;:</SPAN
2101 ></TD
2102 ><TD
2103 ALIGN="LEFT"
2104 VALIGN="TOP"
2105 ><P
2106 > Handle of the file for which information must be retrieved</P
2107 ></TD
2108 ></TR
2109 ><TR
2110 ><TD
2111 ALIGN="LEFT"
2112 VALIGN="TOP"
2113 ><A
2114 NAME="AEN681"><SPAN
2115 STYLE="white-space: nowrap"
2116 ><TT
2117 CLASS="PARAMETER"
2118 ><I
2119 >info</I
2120 ></TT
2121 >&nbsp;:</SPAN
2122 ></TD
2123 ><TD
2124 ALIGN="LEFT"
2125 VALIGN="TOP"
2126 ><P
2127 > Pointer to a GnomeVFSFileInfo object that will hold the information
2128 for the file on return</P
2129 ></TD
2130 ></TR
2131 ><TR
2132 ><TD
2133 ALIGN="LEFT"
2134 VALIGN="TOP"
2135 ><A
2136 NAME="AEN686"><SPAN
2137 STYLE="white-space: nowrap"
2138 ><TT
2139 CLASS="PARAMETER"
2140 ><I
2141 >options</I
2142 ></TT
2143 >&nbsp;:</SPAN
2144 ></TD
2145 ><TD
2146 ALIGN="LEFT"
2147 VALIGN="TOP"
2148 ><P
2149 > Options for retrieving file information
2150 to retrieve for the file</P
2151 ></TD
2152 ></TR
2153 ><TR
2154 ><TD
2155 ALIGN="LEFT"
2156 VALIGN="TOP"
2157 ><A
2158 NAME="AEN691"><SPAN
2159 STYLE="white-space: nowrap"
2160 ><SPAN
2161 CLASS="emphasis"
2162 ><I
2163 CLASS="EMPHASIS"
2164 >Returns</I
2165 ></SPAN
2166 > :</SPAN
2167 ></TD
2168 ><TD
2169 ALIGN="LEFT"
2170 VALIGN="TOP"
2171 ><P
2172 > An integer representing the result of the operation</P
2173 ></TD
2174 ></TR
2175 ></TBODY
2176 ></TABLE
2177 ></DIV
2178 ><HR><DIV
2179 CLASS="REFSECT2"
2180 ><A
2181 NAME="AEN696"
2182 ></A
2183 ><H3
2184 ><A
2185 NAME="GNOME-VFS-TRUNCATE"
2186 ></A
2187 >gnome_vfs_truncate ()</H3
2188 ><PRE
2189 CLASS="PROGRAMLISTING"
2190 ><A
2191 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2192 >GnomeVFSResult</A
2193 > gnome_vfs_truncate           (const gchar *text_uri,
2194                                              <A
2195 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
2196 >GnomeVFSFileSize</A
2197 > length);</PRE
2198 ><P
2199 >Truncate the file at <TT
2200 CLASS="PARAMETER"
2201 ><I
2202 >text_uri</I
2203 ></TT
2204 > to <TT
2205 CLASS="PARAMETER"
2206 ><I
2207 >length</I
2208 ></TT
2209 > bytes.</P
2210 ><P
2211 ></P
2212 ><P
2213 ></P
2214 ><TABLE
2215 CLASS="variablelist"
2216 BORDER="0"
2217 CELLSPACING="0"
2218 CELLPADDING="4"
2219 ><TBODY
2220 ><TR
2221 ><TD
2222 ALIGN="LEFT"
2223 VALIGN="TOP"
2224 ><A
2225 NAME="AEN708"><SPAN
2226 STYLE="white-space: nowrap"
2227 ><TT
2228 CLASS="PARAMETER"
2229 ><I
2230 >text_uri</I
2231 ></TT
2232 >&nbsp;:</SPAN
2233 ></TD
2234 ><TD
2235 ALIGN="LEFT"
2236 VALIGN="TOP"
2237 ><P
2238 > URI of the file to be truncated</P
2239 ></TD
2240 ></TR
2241 ><TR
2242 ><TD
2243 ALIGN="LEFT"
2244 VALIGN="TOP"
2245 ><A
2246 NAME="AEN713"><SPAN
2247 STYLE="white-space: nowrap"
2248 ><TT
2249 CLASS="PARAMETER"
2250 ><I
2251 >length</I
2252 ></TT
2253 >&nbsp;:</SPAN
2254 ></TD
2255 ><TD
2256 ALIGN="LEFT"
2257 VALIGN="TOP"
2258 ><P
2259 > length of the new file at <TT
2260 CLASS="PARAMETER"
2261 ><I
2262 >text_uri</I
2263 ></TT
2264 ></P
2265 ></TD
2266 ></TR
2267 ><TR
2268 ><TD
2269 ALIGN="LEFT"
2270 VALIGN="TOP"
2271 ><A
2272 NAME="AEN719"><SPAN
2273 STYLE="white-space: nowrap"
2274 ><SPAN
2275 CLASS="emphasis"
2276 ><I
2277 CLASS="EMPHASIS"
2278 >Returns</I
2279 ></SPAN
2280 > :</SPAN
2281 ></TD
2282 ><TD
2283 ALIGN="LEFT"
2284 VALIGN="TOP"
2285 ><P
2286 > An integer representing the result of the operation</P
2287 ></TD
2288 ></TR
2289 ></TBODY
2290 ></TABLE
2291 ></DIV
2292 ><HR><DIV
2293 CLASS="REFSECT2"
2294 ><A
2295 NAME="AEN724"
2296 ></A
2297 ><H3
2298 ><A
2299 NAME="GNOME-VFS-TRUNCATE-URI"
2300 ></A
2301 >gnome_vfs_truncate_uri ()</H3
2302 ><PRE
2303 CLASS="PROGRAMLISTING"
2304 ><A
2305 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2306 >GnomeVFSResult</A
2307 > gnome_vfs_truncate_uri       (GnomeVFSURI *uri,
2308                                              <A
2309 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
2310 >GnomeVFSFileSize</A
2311 > length);</PRE
2312 ><P
2313 >Truncate the file at <TT
2314 CLASS="PARAMETER"
2315 ><I
2316 >uri</I
2317 ></TT
2318 > to be only <TT
2319 CLASS="PARAMETER"
2320 ><I
2321 >length</I
2322 ></TT
2323 > bytes. Data past <TT
2324 CLASS="PARAMETER"
2325 ><I
2326 >length</I
2327 ></TT
2328 >
2329 bytes will be discarded.</P
2330 ><P
2331 ></P
2332 ><P
2333 ></P
2334 ><TABLE
2335 CLASS="variablelist"
2336 BORDER="0"
2337 CELLSPACING="0"
2338 CELLPADDING="4"
2339 ><TBODY
2340 ><TR
2341 ><TD
2342 ALIGN="LEFT"
2343 VALIGN="TOP"
2344 ><A
2345 NAME="AEN737"><SPAN
2346 STYLE="white-space: nowrap"
2347 ><TT
2348 CLASS="PARAMETER"
2349 ><I
2350 >uri</I
2351 ></TT
2352 >&nbsp;:</SPAN
2353 ></TD
2354 ><TD
2355 ALIGN="LEFT"
2356 VALIGN="TOP"
2357 ><P
2358 > URI of the file to be truncated</P
2359 ></TD
2360 ></TR
2361 ><TR
2362 ><TD
2363 ALIGN="LEFT"
2364 VALIGN="TOP"
2365 ><A
2366 NAME="AEN742"><SPAN
2367 STYLE="white-space: nowrap"
2368 ><TT
2369 CLASS="PARAMETER"
2370 ><I
2371 >length</I
2372 ></TT
2373 >&nbsp;:</SPAN
2374 ></TD
2375 ><TD
2376 ALIGN="LEFT"
2377 VALIGN="TOP"
2378 ><P
2379 > length of the new file at <TT
2380 CLASS="PARAMETER"
2381 ><I
2382 >uri</I
2383 ></TT
2384 ></P
2385 ></TD
2386 ></TR
2387 ><TR
2388 ><TD
2389 ALIGN="LEFT"
2390 VALIGN="TOP"
2391 ><A
2392 NAME="AEN748"><SPAN
2393 STYLE="white-space: nowrap"
2394 ><SPAN
2395 CLASS="emphasis"
2396 ><I
2397 CLASS="EMPHASIS"
2398 >Returns</I
2399 ></SPAN
2400 > :</SPAN
2401 ></TD
2402 ><TD
2403 ALIGN="LEFT"
2404 VALIGN="TOP"
2405 ><P
2406 > An integer representing the result of the operation</P
2407 ></TD
2408 ></TR
2409 ></TBODY
2410 ></TABLE
2411 ></DIV
2412 ><HR><DIV
2413 CLASS="REFSECT2"
2414 ><A
2415 NAME="AEN753"
2416 ></A
2417 ><H3
2418 ><A
2419 NAME="GNOME-VFS-TRUNCATE-HANDLE"
2420 ></A
2421 >gnome_vfs_truncate_handle ()</H3
2422 ><PRE
2423 CLASS="PROGRAMLISTING"
2424 ><A
2425 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2426 >GnomeVFSResult</A
2427 > gnome_vfs_truncate_handle    (GnomeVFSHandle *handle,
2428                                              <A
2429 HREF="gnome-vfs-gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
2430 >GnomeVFSFileSize</A
2431 > length);</PRE
2432 ><P
2433 >Truncate the file pointed to be <TT
2434 CLASS="PARAMETER"
2435 ><I
2436 >handle</I
2437 ></TT
2438 > to be only <TT
2439 CLASS="PARAMETER"
2440 ><I
2441 >length</I
2442 ></TT
2443 > bytes.
2444 Data past <TT
2445 CLASS="PARAMETER"
2446 ><I
2447 >length</I
2448 ></TT
2449 > bytes will be discarded.</P
2450 ><P
2451 ></P
2452 ><P
2453 ></P
2454 ><TABLE
2455 CLASS="variablelist"
2456 BORDER="0"
2457 CELLSPACING="0"
2458 CELLPADDING="4"
2459 ><TBODY
2460 ><TR
2461 ><TD
2462 ALIGN="LEFT"
2463 VALIGN="TOP"
2464 ><A
2465 NAME="AEN766"><SPAN
2466 STYLE="white-space: nowrap"
2467 ><TT
2468 CLASS="PARAMETER"
2469 ><I
2470 >handle</I
2471 ></TT
2472 >&nbsp;:</SPAN
2473 ></TD
2474 ><TD
2475 ALIGN="LEFT"
2476 VALIGN="TOP"
2477 ><P
2478 > a handle to the file to be truncated</P
2479 ></TD
2480 ></TR
2481 ><TR
2482 ><TD
2483 ALIGN="LEFT"
2484 VALIGN="TOP"
2485 ><A
2486 NAME="AEN771"><SPAN
2487 STYLE="white-space: nowrap"
2488 ><TT
2489 CLASS="PARAMETER"
2490 ><I
2491 >length</I
2492 ></TT
2493 >&nbsp;:</SPAN
2494 ></TD
2495 ><TD
2496 ALIGN="LEFT"
2497 VALIGN="TOP"
2498 ><P
2499 > length of the new file the handle is open to</P
2500 ></TD
2501 ></TR
2502 ><TR
2503 ><TD
2504 ALIGN="LEFT"
2505 VALIGN="TOP"
2506 ><A
2507 NAME="AEN776"><SPAN
2508 STYLE="white-space: nowrap"
2509 ><SPAN
2510 CLASS="emphasis"
2511 ><I
2512 CLASS="EMPHASIS"
2513 >Returns</I
2514 ></SPAN
2515 > :</SPAN
2516 ></TD
2517 ><TD
2518 ALIGN="LEFT"
2519 VALIGN="TOP"
2520 ><P
2521 > An integer representing the result of the operation</P
2522 ></TD
2523 ></TR
2524 ></TBODY
2525 ></TABLE
2526 ></DIV
2527 ><HR><DIV
2528 CLASS="REFSECT2"
2529 ><A
2530 NAME="AEN781"
2531 ></A
2532 ><H3
2533 ><A
2534 NAME="GNOME-VFS-UNLINK-FROM-URI"
2535 ></A
2536 >gnome_vfs_unlink_from_uri ()</H3
2537 ><PRE
2538 CLASS="PROGRAMLISTING"
2539 ><A
2540 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2541 >GnomeVFSResult</A
2542 > gnome_vfs_unlink_from_uri    (GnomeVFSURI *uri);</PRE
2543 ><P
2544 >Unlink <TT
2545 CLASS="PARAMETER"
2546 ><I
2547 >uri</I
2548 ></TT
2549 > (i.e. delete the file).</P
2550 ><P
2551 ></P
2552 ><P
2553 ></P
2554 ><TABLE
2555 CLASS="variablelist"
2556 BORDER="0"
2557 CELLSPACING="0"
2558 CELLPADDING="4"
2559 ><TBODY
2560 ><TR
2561 ><TD
2562 ALIGN="LEFT"
2563 VALIGN="TOP"
2564 ><A
2565 NAME="AEN791"><SPAN
2566 STYLE="white-space: nowrap"
2567 ><TT
2568 CLASS="PARAMETER"
2569 ><I
2570 >uri</I
2571 ></TT
2572 >&nbsp;:</SPAN
2573 ></TD
2574 ><TD
2575 ALIGN="LEFT"
2576 VALIGN="TOP"
2577 ><P
2578 > URI of the file to be unlinked</P
2579 ></TD
2580 ></TR
2581 ><TR
2582 ><TD
2583 ALIGN="LEFT"
2584 VALIGN="TOP"
2585 ><A
2586 NAME="AEN796"><SPAN
2587 STYLE="white-space: nowrap"
2588 ><SPAN
2589 CLASS="emphasis"
2590 ><I
2591 CLASS="EMPHASIS"
2592 >Returns</I
2593 ></SPAN
2594 > :</SPAN
2595 ></TD
2596 ><TD
2597 ALIGN="LEFT"
2598 VALIGN="TOP"
2599 ><P
2600 > An integer representing the result of the operation</P
2601 ></TD
2602 ></TR
2603 ></TBODY
2604 ></TABLE
2605 ></DIV
2606 ><HR><DIV
2607 CLASS="REFSECT2"
2608 ><A
2609 NAME="AEN801"
2610 ></A
2611 ><H3
2612 ><A
2613 NAME="GNOME-VFS-CREATE-SYMBOLIC-LINK"
2614 ></A
2615 >gnome_vfs_create_symbolic_link ()</H3
2616 ><PRE
2617 CLASS="PROGRAMLISTING"
2618 ><A
2619 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2620 >GnomeVFSResult</A
2621 > gnome_vfs_create_symbolic_link
2622                                             (GnomeVFSURI *uri,
2623                                              const gchar *target_reference);</PRE
2624 ><P
2625 >Creates a symbolic link, or eventually, a URI link (as necessary)
2626 at <TT
2627 CLASS="PARAMETER"
2628 ><I
2629 >uri</I
2630 ></TT
2631 > pointing to <TT
2632 CLASS="PARAMETER"
2633 ><I
2634 >target_reference</I
2635 ></TT
2636 ></P
2637 ><P
2638 ></P
2639 ><P
2640 ></P
2641 ><TABLE
2642 CLASS="variablelist"
2643 BORDER="0"
2644 CELLSPACING="0"
2645 CELLPADDING="4"
2646 ><TBODY
2647 ><TR
2648 ><TD
2649 ALIGN="LEFT"
2650 VALIGN="TOP"
2651 ><A
2652 NAME="AEN813"><SPAN
2653 STYLE="white-space: nowrap"
2654 ><TT
2655 CLASS="PARAMETER"
2656 ><I
2657 >uri</I
2658 ></TT
2659 >&nbsp;:</SPAN
2660 ></TD
2661 ><TD
2662 ALIGN="LEFT"
2663 VALIGN="TOP"
2664 ><P
2665 > URI to create a link at</P
2666 ></TD
2667 ></TR
2668 ><TR
2669 ><TD
2670 ALIGN="LEFT"
2671 VALIGN="TOP"
2672 ><A
2673 NAME="AEN818"><SPAN
2674 STYLE="white-space: nowrap"
2675 ><TT
2676 CLASS="PARAMETER"
2677 ><I
2678 >target_reference</I
2679 ></TT
2680 >&nbsp;:</SPAN
2681 ></TD
2682 ><TD
2683 ALIGN="LEFT"
2684 VALIGN="TOP"
2685 ><P
2686 > URI "reference" to point the link to (URI or relative path)</P
2687 ></TD
2688 ></TR
2689 ><TR
2690 ><TD
2691 ALIGN="LEFT"
2692 VALIGN="TOP"
2693 ><A
2694 NAME="AEN823"><SPAN
2695 STYLE="white-space: nowrap"
2696 ><SPAN
2697 CLASS="emphasis"
2698 ><I
2699 CLASS="EMPHASIS"
2700 >Returns</I
2701 ></SPAN
2702 > :</SPAN
2703 ></TD
2704 ><TD
2705 ALIGN="LEFT"
2706 VALIGN="TOP"
2707 ><P
2708 > An integer representing the result of the operation</P
2709 ></TD
2710 ></TR
2711 ></TBODY
2712 ></TABLE
2713 ></DIV
2714 ><HR><DIV
2715 CLASS="REFSECT2"
2716 ><A
2717 NAME="AEN828"
2718 ></A
2719 ><H3
2720 ><A
2721 NAME="GNOME-VFS-UNLINK"
2722 ></A
2723 >gnome_vfs_unlink ()</H3
2724 ><PRE
2725 CLASS="PROGRAMLISTING"
2726 ><A
2727 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2728 >GnomeVFSResult</A
2729 > gnome_vfs_unlink             (const gchar *text_uri);</PRE
2730 ><P
2731 >Unlink <TT
2732 CLASS="PARAMETER"
2733 ><I
2734 >text_uri</I
2735 ></TT
2736 > (i.e. delete the file).</P
2737 ><P
2738 ></P
2739 ><P
2740 ></P
2741 ><TABLE
2742 CLASS="variablelist"
2743 BORDER="0"
2744 CELLSPACING="0"
2745 CELLPADDING="4"
2746 ><TBODY
2747 ><TR
2748 ><TD
2749 ALIGN="LEFT"
2750 VALIGN="TOP"
2751 ><A
2752 NAME="AEN838"><SPAN
2753 STYLE="white-space: nowrap"
2754 ><TT
2755 CLASS="PARAMETER"
2756 ><I
2757 >text_uri</I
2758 ></TT
2759 >&nbsp;:</SPAN
2760 ></TD
2761 ><TD
2762 ALIGN="LEFT"
2763 VALIGN="TOP"
2764 ><P
2765 > URI of the file to be unlinked</P
2766 ></TD
2767 ></TR
2768 ><TR
2769 ><TD
2770 ALIGN="LEFT"
2771 VALIGN="TOP"
2772 ><A
2773 NAME="AEN843"><SPAN
2774 STYLE="white-space: nowrap"
2775 ><SPAN
2776 CLASS="emphasis"
2777 ><I
2778 CLASS="EMPHASIS"
2779 >Returns</I
2780 ></SPAN
2781 > :</SPAN
2782 ></TD
2783 ><TD
2784 ALIGN="LEFT"
2785 VALIGN="TOP"
2786 ><P
2787 > An integer representing the result of the operation</P
2788 ></TD
2789 ></TR
2790 ></TBODY
2791 ></TABLE
2792 ></DIV
2793 ><HR><DIV
2794 CLASS="REFSECT2"
2795 ><A
2796 NAME="AEN848"
2797 ></A
2798 ><H3
2799 ><A
2800 NAME="GNOME-VFS-MOVE-URI"
2801 ></A
2802 >gnome_vfs_move_uri ()</H3
2803 ><PRE
2804 CLASS="PROGRAMLISTING"
2805 ><A
2806 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2807 >GnomeVFSResult</A
2808 > gnome_vfs_move_uri           (GnomeVFSURI *old_uri,
2809                                              GnomeVFSURI *new_uri,
2810                                              gboolean force_replace);</PRE
2811 ><P
2812 >Move a file from URI <TT
2813 CLASS="PARAMETER"
2814 ><I
2815 >old_uri</I
2816 ></TT
2817 > to <TT
2818 CLASS="PARAMETER"
2819 ><I
2820 >new_uri</I
2821 ></TT
2822 >.  This will only work if <TT
2823 CLASS="PARAMETER"
2824 ><I
2825 >old_uri</I
2826 ></TT
2827 >
2828 and <TT
2829 CLASS="PARAMETER"
2830 ><I
2831 >new_uri</I
2832 ></TT
2833 > are on the same file system.  Otherwise, it is necessary
2834 to use the more general %<A
2835 HREF="gnome-vfs-gnome-vfs-xfer.html#GNOME-VFS-XFER-URI"
2836 >gnome_vfs_xfer_uri</A
2837 >() function.</P
2838 ><P
2839 ></P
2840 ><P
2841 ></P
2842 ><TABLE
2843 CLASS="variablelist"
2844 BORDER="0"
2845 CELLSPACING="0"
2846 CELLPADDING="4"
2847 ><TBODY
2848 ><TR
2849 ><TD
2850 ALIGN="LEFT"
2851 VALIGN="TOP"
2852 ><A
2853 NAME="AEN864"><SPAN
2854 STYLE="white-space: nowrap"
2855 ><TT
2856 CLASS="PARAMETER"
2857 ><I
2858 >old_uri</I
2859 ></TT
2860 >&nbsp;:</SPAN
2861 ></TD
2862 ><TD
2863 ALIGN="LEFT"
2864 VALIGN="TOP"
2865 ><P
2866 > Source URI</P
2867 ></TD
2868 ></TR
2869 ><TR
2870 ><TD
2871 ALIGN="LEFT"
2872 VALIGN="TOP"
2873 ><A
2874 NAME="AEN869"><SPAN
2875 STYLE="white-space: nowrap"
2876 ><TT
2877 CLASS="PARAMETER"
2878 ><I
2879 >new_uri</I
2880 ></TT
2881 >&nbsp;:</SPAN
2882 ></TD
2883 ><TD
2884 ALIGN="LEFT"
2885 VALIGN="TOP"
2886 ><P
2887 > Destination URI</P
2888 ></TD
2889 ></TR
2890 ><TR
2891 ><TD
2892 ALIGN="LEFT"
2893 VALIGN="TOP"
2894 ><A
2895 NAME="AEN874"><SPAN
2896 STYLE="white-space: nowrap"
2897 ><TT
2898 CLASS="PARAMETER"
2899 ><I
2900 >force_replace</I
2901 ></TT
2902 >&nbsp;:</SPAN
2903 ></TD
2904 ><TD
2905 ALIGN="LEFT"
2906 VALIGN="TOP"
2907 ><P
2908 > If <TT
2909 CLASS="LITERAL"
2910 >TRUE</TT
2911 >, move target to <TT
2912 CLASS="PARAMETER"
2913 ><I
2914 >new_uri</I
2915 ></TT
2916 > even if there
2917 is already a file at <TT
2918 CLASS="PARAMETER"
2919 ><I
2920 >new_uri</I
2921 ></TT
2922 >. If there is a file, it will be discarded.</P
2923 ></TD
2924 ></TR
2925 ><TR
2926 ><TD
2927 ALIGN="LEFT"
2928 VALIGN="TOP"
2929 ><A
2930 NAME="AEN882"><SPAN
2931 STYLE="white-space: nowrap"
2932 ><SPAN
2933 CLASS="emphasis"
2934 ><I
2935 CLASS="EMPHASIS"
2936 >Returns</I
2937 ></SPAN
2938 > :</SPAN
2939 ></TD
2940 ><TD
2941 ALIGN="LEFT"
2942 VALIGN="TOP"
2943 ><P
2944 > An integer representing the result of the operation.</P
2945 ></TD
2946 ></TR
2947 ></TBODY
2948 ></TABLE
2949 ></DIV
2950 ><HR><DIV
2951 CLASS="REFSECT2"
2952 ><A
2953 NAME="AEN887"
2954 ></A
2955 ><H3
2956 ><A
2957 NAME="GNOME-VFS-MOVE"
2958 ></A
2959 >gnome_vfs_move ()</H3
2960 ><PRE
2961 CLASS="PROGRAMLISTING"
2962 ><A
2963 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
2964 >GnomeVFSResult</A
2965 > gnome_vfs_move               (const gchar *old_text_uri,
2966                                              const gchar *new_text_uri,
2967                                              gboolean force_replace);</PRE
2968 ><P
2969 >Move a file from URI <TT
2970 CLASS="PARAMETER"
2971 ><I
2972 >old_text_uri</I
2973 ></TT
2974 > to <TT
2975 CLASS="PARAMETER"
2976 ><I
2977 >new_text_uri</I
2978 ></TT
2979 >.  This will only work
2980 if <TT
2981 CLASS="PARAMETER"
2982 ><I
2983 >old_text_uri</I
2984 ></TT
2985 > and <TT
2986 CLASS="PARAMETER"
2987 ><I
2988 >new_text_uri</I
2989 ></TT
2990 > are on the same file system.  Otherwise,
2991 it is necessary to use the more general %<A
2992 HREF="gnome-vfs-gnome-vfs-xfer.html#GNOME-VFS-XFER-URI"
2993 >gnome_vfs_xfer_uri</A
2994 >() function.</P
2995 ><P
2996 ></P
2997 ><P
2998 ></P
2999 ><TABLE
3000 CLASS="variablelist"
3001 BORDER="0"
3002 CELLSPACING="0"
3003 CELLPADDING="4"
3004 ><TBODY
3005 ><TR
3006 ><TD
3007 ALIGN="LEFT"
3008 VALIGN="TOP"
3009 ><A
3010 NAME="AEN903"><SPAN
3011 STYLE="white-space: nowrap"
3012 ><TT
3013 CLASS="PARAMETER"
3014 ><I
3015 >old_text_uri</I
3016 ></TT
3017 >&nbsp;:</SPAN
3018 ></TD
3019 ><TD
3020 ALIGN="LEFT"
3021 VALIGN="TOP"
3022 ><P
3023 > Source URI</P
3024 ></TD
3025 ></TR
3026 ><TR
3027 ><TD
3028 ALIGN="LEFT"
3029 VALIGN="TOP"
3030 ><A
3031 NAME="AEN908"><SPAN
3032 STYLE="white-space: nowrap"
3033 ><TT
3034 CLASS="PARAMETER"
3035 ><I
3036 >new_text_uri</I
3037 ></TT
3038 >&nbsp;:</SPAN
3039 ></TD
3040 ><TD
3041 ALIGN="LEFT"
3042 VALIGN="TOP"
3043 ><P
3044 > Destination URI</P
3045 ></TD
3046 ></TR
3047 ><TR
3048 ><TD
3049 ALIGN="LEFT"
3050 VALIGN="TOP"
3051 ><A
3052 NAME="AEN913"><SPAN
3053 STYLE="white-space: nowrap"
3054 ><TT
3055 CLASS="PARAMETER"
3056 ><I
3057 >force_replace</I
3058 ></TT
3059 >&nbsp;:</SPAN
3060 ></TD
3061 ><TD
3062 ALIGN="LEFT"
3063 VALIGN="TOP"
3064 ><P
3065 > if <TT
3066 CLASS="LITERAL"
3067 >TRUE</TT
3068 >, perform the operation even if it unlinks an existing
3069 file at <TT
3070 CLASS="PARAMETER"
3071 ><I
3072 >new_text_uri</I
3073 ></TT
3074 ></P
3075 ></TD
3076 ></TR
3077 ><TR
3078 ><TD
3079 ALIGN="LEFT"
3080 VALIGN="TOP"
3081 ><A
3082 NAME="AEN920"><SPAN
3083 STYLE="white-space: nowrap"
3084 ><SPAN
3085 CLASS="emphasis"
3086 ><I
3087 CLASS="EMPHASIS"
3088 >Returns</I
3089 ></SPAN
3090 > :</SPAN
3091 ></TD
3092 ><TD
3093 ALIGN="LEFT"
3094 VALIGN="TOP"
3095 ><P
3096 > An integer representing the result of the operation.</P
3097 ></TD
3098 ></TR
3099 ></TBODY
3100 ></TABLE
3101 ></DIV
3102 ><HR><DIV
3103 CLASS="REFSECT2"
3104 ><A
3105 NAME="AEN925"
3106 ></A
3107 ><H3
3108 ><A
3109 NAME="GNOME-VFS-CHECK-SAME-FS-URIS"
3110 ></A
3111 >gnome_vfs_check_same_fs_uris ()</H3
3112 ><PRE
3113 CLASS="PROGRAMLISTING"
3114 ><A
3115 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
3116 >GnomeVFSResult</A
3117 > gnome_vfs_check_same_fs_uris (GnomeVFSURI *source_uri,
3118                                              GnomeVFSURI *target_uri,
3119                                              gboolean *same_fs_return);</PRE
3120 ><P
3121 >Check if <TT
3122 CLASS="PARAMETER"
3123 ><I
3124 >source_uri</I
3125 ></TT
3126 > and <TT
3127 CLASS="PARAMETER"
3128 ><I
3129 >target_uri</I
3130 ></TT
3131 > are on the same file system.</P
3132 ><P
3133 ></P
3134 ><P
3135 ></P
3136 ><TABLE
3137 CLASS="variablelist"
3138 BORDER="0"
3139 CELLSPACING="0"
3140 CELLPADDING="4"
3141 ><TBODY
3142 ><TR
3143 ><TD
3144 ALIGN="LEFT"
3145 VALIGN="TOP"
3146 ><A
3147 NAME="AEN938"><SPAN
3148 STYLE="white-space: nowrap"
3149 ><TT
3150 CLASS="PARAMETER"
3151 ><I
3152 >source_uri</I
3153 ></TT
3154 >&nbsp;:</SPAN
3155 ></TD
3156 ><TD
3157 ALIGN="LEFT"
3158 VALIGN="TOP"
3159 ><P
3160 > A URI</P
3161 ></TD
3162 ></TR
3163 ><TR
3164 ><TD
3165 ALIGN="LEFT"
3166 VALIGN="TOP"
3167 ><A
3168 NAME="AEN943"><SPAN
3169 STYLE="white-space: nowrap"
3170 ><TT
3171 CLASS="PARAMETER"
3172 ><I
3173 >target_uri</I
3174 ></TT
3175 >&nbsp;:</SPAN
3176 ></TD
3177 ><TD
3178 ALIGN="LEFT"
3179 VALIGN="TOP"
3180 ><P
3181 > Another URI</P
3182 ></TD
3183 ></TR
3184 ><TR
3185 ><TD
3186 ALIGN="LEFT"
3187 VALIGN="TOP"
3188 ><A
3189 NAME="AEN948"><SPAN
3190 STYLE="white-space: nowrap"
3191 ><TT
3192 CLASS="PARAMETER"
3193 ><I
3194 >same_fs_return</I
3195 ></TT
3196 >&nbsp;:</SPAN
3197 ></TD
3198 ><TD
3199 ALIGN="LEFT"
3200 VALIGN="TOP"
3201 ><P
3202 > Pointer to a boolean variable which will be set to <TT
3203 CLASS="LITERAL"
3204 >TRUE</TT
3205 >
3206 if <TT
3207 CLASS="PARAMETER"
3208 ><I
3209 >source_uri</I
3210 ></TT
3211 > and <TT
3212 CLASS="PARAMETER"
3213 ><I
3214 >target_uri</I
3215 ></TT
3216 > are on the same file system on return.</P
3217 ></TD
3218 ></TR
3219 ><TR
3220 ><TD
3221 ALIGN="LEFT"
3222 VALIGN="TOP"
3223 ><A
3224 NAME="AEN956"><SPAN
3225 STYLE="white-space: nowrap"
3226 ><SPAN
3227 CLASS="emphasis"
3228 ><I
3229 CLASS="EMPHASIS"
3230 >Returns</I
3231 ></SPAN
3232 > :</SPAN
3233 ></TD
3234 ><TD
3235 ALIGN="LEFT"
3236 VALIGN="TOP"
3237 ><P
3238 > An integer representing the result of the operation.</P
3239 ></TD
3240 ></TR
3241 ></TBODY
3242 ></TABLE
3243 ></DIV
3244 ><HR><DIV
3245 CLASS="REFSECT2"
3246 ><A
3247 NAME="AEN961"
3248 ></A
3249 ><H3
3250 ><A
3251 NAME="GNOME-VFS-CHECK-SAME-FS"
3252 ></A
3253 >gnome_vfs_check_same_fs ()</H3
3254 ><PRE
3255 CLASS="PROGRAMLISTING"
3256 ><A
3257 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
3258 >GnomeVFSResult</A
3259 > gnome_vfs_check_same_fs      (const gchar *source,
3260                                              const gchar *target,
3261                                              gboolean *same_fs_return);</PRE
3262 ><P
3263 >Return <TT
3264 CLASS="LITERAL"
3265 >TRUE</TT
3266 > if <TT
3267 CLASS="PARAMETER"
3268 ><I
3269 >source</I
3270 ></TT
3271 > and <TT
3272 CLASS="PARAMETER"
3273 ><I
3274 >target</I
3275 ></TT
3276 > are on the same file system.</P
3277 ><P
3278 ></P
3279 ><P
3280 ></P
3281 ><TABLE
3282 CLASS="variablelist"
3283 BORDER="0"
3284 CELLSPACING="0"
3285 CELLPADDING="4"
3286 ><TBODY
3287 ><TR
3288 ><TD
3289 ALIGN="LEFT"
3290 VALIGN="TOP"
3291 ><A
3292 NAME="AEN975"><SPAN
3293 STYLE="white-space: nowrap"
3294 ><TT
3295 CLASS="PARAMETER"
3296 ><I
3297 >source</I
3298 ></TT
3299 >&nbsp;:</SPAN
3300 ></TD
3301 ><TD
3302 ALIGN="LEFT"
3303 VALIGN="TOP"
3304 ><P
3305 > A URI</P
3306 ></TD
3307 ></TR
3308 ><TR
3309 ><TD
3310 ALIGN="LEFT"
3311 VALIGN="TOP"
3312 ><A
3313 NAME="AEN980"><SPAN
3314 STYLE="white-space: nowrap"
3315 ><TT
3316 CLASS="PARAMETER"
3317 ><I
3318 >target</I
3319 ></TT
3320 >&nbsp;:</SPAN
3321 ></TD
3322 ><TD
3323 ALIGN="LEFT"
3324 VALIGN="TOP"
3325 ><P
3326 > Another URI</P
3327 ></TD
3328 ></TR
3329 ><TR
3330 ><TD
3331 ALIGN="LEFT"
3332 VALIGN="TOP"
3333 ><A
3334 NAME="AEN985"><SPAN
3335 STYLE="white-space: nowrap"
3336 ><TT
3337 CLASS="PARAMETER"
3338 ><I
3339 >same_fs_return</I
3340 ></TT
3341 >&nbsp;:</SPAN
3342 ></TD
3343 ><TD
3344 ALIGN="LEFT"
3345 VALIGN="TOP"
3346 ><P
3347 > Pointer to a boolean variable which will be set to <TT
3348 CLASS="LITERAL"
3349 >TRUE</TT
3350 ></P
3351 ></TD
3352 ></TR
3353 ><TR
3354 ><TD
3355 ALIGN="LEFT"
3356 VALIGN="TOP"
3357 ><A
3358 NAME="AEN991"><SPAN
3359 STYLE="white-space: nowrap"
3360 ><SPAN
3361 CLASS="emphasis"
3362 ><I
3363 CLASS="EMPHASIS"
3364 >Returns</I
3365 ></SPAN
3366 > :</SPAN
3367 ></TD
3368 ><TD
3369 ALIGN="LEFT"
3370 VALIGN="TOP"
3371 ><P
3372 > An integer representing the result of the operation.</P
3373 ></TD
3374 ></TR
3375 ></TBODY
3376 ></TABLE
3377 ></DIV
3378 ><HR><DIV
3379 CLASS="REFSECT2"
3380 ><A
3381 NAME="AEN996"
3382 ></A
3383 ><H3
3384 ><A
3385 NAME="GNOME-VFS-URI-EXISTS"
3386 ></A
3387 >gnome_vfs_uri_exists ()</H3
3388 ><PRE
3389 CLASS="PROGRAMLISTING"
3390 >gboolean    gnome_vfs_uri_exists            (GnomeVFSURI *uri);</PRE
3391 ><P
3392 >Check if the URI points to an existing entity.</P
3393 ><P
3394 ></P
3395 ><P
3396 ></P
3397 ><TABLE
3398 CLASS="variablelist"
3399 BORDER="0"
3400 CELLSPACING="0"
3401 CELLPADDING="4"
3402 ><TBODY
3403 ><TR
3404 ><TD
3405 ALIGN="LEFT"
3406 VALIGN="TOP"
3407 ><A
3408 NAME="AEN1005"><SPAN
3409 STYLE="white-space: nowrap"
3410 ><TT
3411 CLASS="PARAMETER"
3412 ><I
3413 >uri</I
3414 ></TT
3415 >&nbsp;:</SPAN
3416 ></TD
3417 ><TD
3418 ALIGN="LEFT"
3419 VALIGN="TOP"
3420 ><P
3421 > A URI</P
3422 ></TD
3423 ></TR
3424 ><TR
3425 ><TD
3426 ALIGN="LEFT"
3427 VALIGN="TOP"
3428 ><A
3429 NAME="AEN1010"><SPAN
3430 STYLE="white-space: nowrap"
3431 ><SPAN
3432 CLASS="emphasis"
3433 ><I
3434 CLASS="EMPHASIS"
3435 >Returns</I
3436 ></SPAN
3437 > :</SPAN
3438 ></TD
3439 ><TD
3440 ALIGN="LEFT"
3441 VALIGN="TOP"
3442 ><P
3443 > TRUE if URI exists.</P
3444 ></TD
3445 ></TR
3446 ></TBODY
3447 ></TABLE
3448 ></DIV
3449 ><HR><DIV
3450 CLASS="REFSECT2"
3451 ><A
3452 NAME="AEN1015"
3453 ></A
3454 ><H3
3455 ><A
3456 NAME="GNOME-VFS-SET-FILE-INFO-URI"
3457 ></A
3458 >gnome_vfs_set_file_info_uri ()</H3
3459 ><PRE
3460 CLASS="PROGRAMLISTING"
3461 ><A
3462 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
3463 >GnomeVFSResult</A
3464 > gnome_vfs_set_file_info_uri  (GnomeVFSURI *uri,
3465                                              <A
3466 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
3467 >GnomeVFSFileInfo</A
3468 > *info,
3469                                              <A
3470 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSSETFILEINFOMASK"
3471 >GnomeVFSSetFileInfoMask</A
3472 > mask);</PRE
3473 ><P
3474 >Set file information for <TT
3475 CLASS="PARAMETER"
3476 ><I
3477 >uri</I
3478 ></TT
3479 >; only the information for which the
3480 corresponding bit in <TT
3481 CLASS="PARAMETER"
3482 ><I
3483 >mask</I
3484 ></TT
3485 > is set is actually modified.</P
3486 ><P
3487 ></P
3488 ><P
3489 ></P
3490 ><TABLE
3491 CLASS="variablelist"
3492 BORDER="0"
3493 CELLSPACING="0"
3494 CELLPADDING="4"
3495 ><TBODY
3496 ><TR
3497 ><TD
3498 ALIGN="LEFT"
3499 VALIGN="TOP"
3500 ><A
3501 NAME="AEN1028"><SPAN
3502 STYLE="white-space: nowrap"
3503 ><TT
3504 CLASS="PARAMETER"
3505 ><I
3506 >uri</I
3507 ></TT
3508 >&nbsp;:</SPAN
3509 ></TD
3510 ><TD
3511 ALIGN="LEFT"
3512 VALIGN="TOP"
3513 ><P
3514 > A URI</P
3515 ></TD
3516 ></TR
3517 ><TR
3518 ><TD
3519 ALIGN="LEFT"
3520 VALIGN="TOP"
3521 ><A
3522 NAME="AEN1033"><SPAN
3523 STYLE="white-space: nowrap"
3524 ><TT
3525 CLASS="PARAMETER"
3526 ><I
3527 >info</I
3528 ></TT
3529 >&nbsp;:</SPAN
3530 ></TD
3531 ><TD
3532 ALIGN="LEFT"
3533 VALIGN="TOP"
3534 ><P
3535 > Information that must be set for the file</P
3536 ></TD
3537 ></TR
3538 ><TR
3539 ><TD
3540 ALIGN="LEFT"
3541 VALIGN="TOP"
3542 ><A
3543 NAME="AEN1038"><SPAN
3544 STYLE="white-space: nowrap"
3545 ><TT
3546 CLASS="PARAMETER"
3547 ><I
3548 >mask</I
3549 ></TT
3550 >&nbsp;:</SPAN
3551 ></TD
3552 ><TD
3553 ALIGN="LEFT"
3554 VALIGN="TOP"
3555 ><P
3556 > Bit mask representing which fields of <TT
3557 CLASS="PARAMETER"
3558 ><I
3559 >info</I
3560 ></TT
3561 > need to be set </P
3562 ></TD
3563 ></TR
3564 ><TR
3565 ><TD
3566 ALIGN="LEFT"
3567 VALIGN="TOP"
3568 ><A
3569 NAME="AEN1044"><SPAN
3570 STYLE="white-space: nowrap"
3571 ><SPAN
3572 CLASS="emphasis"
3573 ><I
3574 CLASS="EMPHASIS"
3575 >Returns</I
3576 ></SPAN
3577 > :</SPAN
3578 ></TD
3579 ><TD
3580 ALIGN="LEFT"
3581 VALIGN="TOP"
3582 ><P
3583 > An integer representing the result of the operation.</P
3584 ></TD
3585 ></TR
3586 ></TBODY
3587 ></TABLE
3588 ></DIV
3589 ><HR><DIV
3590 CLASS="REFSECT2"
3591 ><A
3592 NAME="AEN1049"
3593 ></A
3594 ><H3
3595 ><A
3596 NAME="GNOME-VFS-SET-FILE-INFO"
3597 ></A
3598 >gnome_vfs_set_file_info ()</H3
3599 ><PRE
3600 CLASS="PROGRAMLISTING"
3601 ><A
3602 HREF="gnome-vfs-gnome-vfs-result.html#GNOMEVFSRESULT"
3603 >GnomeVFSResult</A
3604 > gnome_vfs_set_file_info      (const gchar *text_uri,
3605                                              <A
3606 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSFILEINFO"
3607 >GnomeVFSFileInfo</A
3608 > *info,
3609                                              <A
3610 HREF="gnome-vfs-gnome-vfs-file-info.html#GNOMEVFSSETFILEINFOMASK"
3611 >GnomeVFSSetFileInfoMask</A
3612 > mask);</PRE
3613 ><P
3614 >Set file information for <TT
3615 CLASS="PARAMETER"
3616 ><I
3617 >uri</I
3618 ></TT
3619 >; only the information for which the
3620 corresponding bit in <TT
3621 CLASS="PARAMETER"
3622 ><I
3623 >mask</I
3624 ></TT
3625 > is set is actually modified.</P
3626 ><P
3627 ></P
3628 ><P
3629 ></P
3630 ><TABLE
3631 CLASS="variablelist"
3632 BORDER="0"
3633 CELLSPACING="0"
3634 CELLPADDING="4"
3635 ><TBODY
3636 ><TR
3637 ><TD
3638 ALIGN="LEFT"
3639 VALIGN="TOP"
3640 ><A
3641 NAME="AEN1062"><SPAN
3642 STYLE="white-space: nowrap"
3643 ><TT
3644 CLASS="PARAMETER"
3645 ><I
3646 >text_uri</I
3647 ></TT
3648 >&nbsp;:</SPAN
3649 ></TD
3650 ><TD
3651 ALIGN="LEFT"
3652 VALIGN="TOP"
3653 ><P
3654 > A URI</P
3655 ></TD
3656 ></TR
3657 ><TR
3658 ><TD
3659 ALIGN="LEFT"
3660 VALIGN="TOP"
3661 ><A
3662 NAME="AEN1067"><SPAN
3663 STYLE="white-space: nowrap"
3664 ><TT
3665 CLASS="PARAMETER"
3666 ><I
3667 >info</I
3668 ></TT
3669 >&nbsp;:</SPAN
3670 ></TD
3671 ><TD
3672 ALIGN="LEFT"
3673 VALIGN="TOP"
3674 ><P
3675 > Information that must be set for the file</P
3676 ></TD
3677 ></TR
3678 ><TR
3679 ><TD
3680 ALIGN="LEFT"
3681 VALIGN="TOP"
3682 ><A
3683 NAME="AEN1072"><SPAN
3684 STYLE="white-space: nowrap"
3685 ><TT
3686 CLASS="PARAMETER"
3687 ><I
3688 >mask</I
3689 ></TT
3690 >&nbsp;:</SPAN
3691 ></TD
3692 ><TD
3693 ALIGN="LEFT"
3694 VALIGN="TOP"
3695 ><P
3696 > Bit mask representing which fields of <TT
3697 CLASS="PARAMETER"
3698 ><I
3699 >info</I
3700 ></TT
3701 > need to be set </P
3702 ></TD
3703 ></TR
3704 ><TR
3705 ><TD
3706 ALIGN="LEFT"
3707 VALIGN="TOP"
3708 ><A
3709 NAME="AEN1078"><SPAN
3710 STYLE="white-space: nowrap"
3711 ><SPAN
3712 CLASS="emphasis"
3713 ><I
3714 CLASS="EMPHASIS"
3715 >Returns</I
3716 ></SPAN
3717 > :</SPAN
3718 ></TD
3719 ><TD
3720 ALIGN="LEFT"
3721 VALIGN="TOP"
3722 ><P
3723 > An integer representing the result of the operation.</P
3724 ></TD
3725 ></TR
3726 ></TBODY
3727 ></TABLE
3728 ></DIV
3729 ><HR><DIV
3730 CLASS="REFSECT2"
3731 ><A
3732 NAME="AEN1083"
3733 ></A
3734 ><H3
3735 ><A
3736 NAME="GNOMEVFSMETHODHANDLE"
3737 ></A
3738 >GnomeVFSMethodHandle</H3
3739 ><PRE
3740 CLASS="PROGRAMLISTING"
3741 >typedef gpointer GnomeVFSMethodHandle;</PRE
3742 ><P
3743 ></P
3744 ></DIV
3745 ><HR><DIV
3746 CLASS="REFSECT2"
3747 ><A
3748 NAME="AEN1088"
3749 ></A
3750 ><H3
3751 ><A
3752 NAME="GNOMEVFSOPENMODE"
3753 ></A
3754 >enum GnomeVFSOpenMode</H3
3755 ><PRE
3756 CLASS="PROGRAMLISTING"
3757 >typedef enum {
3758         GNOME_VFS_OPEN_NONE = 0,
3759         GNOME_VFS_OPEN_READ = 1 &lt;&lt; 0,
3760         GNOME_VFS_OPEN_WRITE = 1 &lt;&lt; 1,
3761         GNOME_VFS_OPEN_RANDOM = 1 &lt;&lt; 2
3762 } GnomeVFSOpenMode;</PRE
3763 ><P
3764 ></P
3765 ></DIV
3766 ><HR><DIV
3767 CLASS="REFSECT2"
3768 ><A
3769 NAME="AEN1093"
3770 ></A
3771 ><H3
3772 ><A
3773 NAME="GNOMEVFSSEEKPOSITION"
3774 ></A
3775 >enum GnomeVFSSeekPosition</H3
3776 ><PRE
3777 CLASS="PROGRAMLISTING"
3778 >typedef enum {
3779         GNOME_VFS_SEEK_START,
3780         GNOME_VFS_SEEK_CURRENT,
3781         GNOME_VFS_SEEK_END
3782 } GnomeVFSSeekPosition;</PRE
3783 ><P
3784 ></P
3785 ></DIV
3786 ></DIV
3787 ><TABLE
3788 CLASS="navigation"
3789 WIDTH="100%"
3790 SUMMARY="Navigation footer"
3791 CELLPADDING="2"
3792 CELLSPACING="2"
3793 ><TR
3794 VALIGN="middle"
3795 ><TD
3796 ALIGN="left"
3797 ><A
3798 ACCESSKEY="p"
3799 HREF="gnome-vfs-gnome-vfs-init.html"
3800 ><B
3801 >&lt;&lt;&lt;&nbsp;Initialization/Shutdown</B
3802 ></A
3803 ></TD
3804 ><TD
3805 ALIGN="right"
3806 ><A
3807 ACCESSKEY="n"
3808 HREF="gnome-vfs-gnome-vfs-async-ops.html"
3809 ><B
3810 >Asynchronous File Operations&nbsp;&gt;&gt;&gt;</B
3811 ></A
3812 ></TD
3813 ></TR
3814 ></TABLE
3815 ></BODY
3816 ></HTML
3817 >