7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
10 TITLE="GnomeVFS - Filesystem Abstraction library"
11 HREF="index.html"><LINK
13 TITLE="Basic File Operations"
14 HREF="file-operations.html"><LINK
16 TITLE="Basic File Operations"
17 HREF="file-operations.html"><LINK
19 TITLE="Directory Operations"
20 HREF="gnome-vfs-directory.html"></HEAD
43 >GnomeVFS - Filesystem Abstraction library</FONT
52 HREF="file-operations.html"
57 ><<< Previous Page</B
90 HREF="file-operations.html"
106 HREF="gnome-vfs-directory.html"
111 >Next Page >>></B
130 >Basic File I/O -- synchronous file operations similar to posix calls, but using uris</DIV
132 CLASS="REFSYNOPSISDIV"
150 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
153 HREF="gnome-vfs-ops.html#GNOME-VFS-OPEN"
155 > (GnomeVFSHandle **handle,
157 HREF=../glib/glib-basic-types.html#GCHAR
158 >gchar</A> *text_uri,
160 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
164 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
167 HREF="gnome-vfs-ops.html#GNOME-VFS-OPEN-URI"
168 >gnome_vfs_open_uri</A
169 > (GnomeVFSHandle **handle,
172 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
176 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
179 HREF="gnome-vfs-ops.html#GNOME-VFS-CREATE"
181 > (GnomeVFSHandle **handle,
183 HREF=../glib/glib-basic-types.html#GCHAR
184 >gchar</A> *text_uri,
186 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
190 HREF=../glib/glib-basic-types.html#GBOOLEAN
191 >gboolean</A> exclusive,
193 HREF=../glib/glib-basic-types.html#GUINT
196 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
199 HREF="gnome-vfs-ops.html#GNOME-VFS-CREATE-URI"
200 >gnome_vfs_create_uri</A
201 > (GnomeVFSHandle **handle,
204 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
208 HREF=../glib/glib-basic-types.html#GBOOLEAN
209 >gboolean</A> exclusive,
211 HREF=../glib/glib-basic-types.html#GUINT
214 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
217 HREF="gnome-vfs-ops.html#GNOME-VFS-CLOSE"
219 > (GnomeVFSHandle *handle);
221 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
224 HREF="gnome-vfs-ops.html#GNOME-VFS-READ"
226 > (GnomeVFSHandle *handle,
228 HREF=../glib/glib-basic-types.html#GPOINTER
229 >gpointer</A> buffer,
231 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
235 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
239 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
242 HREF="gnome-vfs-ops.html#GNOME-VFS-WRITE"
244 > (GnomeVFSHandle *handle,
246 HREF=../glib/glib-basic-types.html#GCONSTPOINTER
247 >gconstpointer</A> buffer,
249 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
253 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
257 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
260 HREF="gnome-vfs-ops.html#GNOME-VFS-SEEK"
262 > (GnomeVFSHandle *handle,
264 HREF="gnome-vfs-types.html#GNOMEVFSSEEKPOSITION"
265 >GnomeVFSSeekPosition</A
268 HREF="gnome-vfs-file-size.html#GNOMEVFSFILEOFFSET"
269 >GnomeVFSFileOffset</A
272 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
275 HREF="gnome-vfs-ops.html#GNOME-VFS-TELL"
277 > (GnomeVFSHandle *handle,
279 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
283 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
286 HREF="gnome-vfs-ops.html#GNOME-VFS-GET-FILE-INFO"
287 >gnome_vfs_get_file_info</A
289 HREF=../glib/glib-basic-types.html#GCHAR
290 >gchar</A> *text_uri,
292 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
295 GnomeVFSFileInfoOptionsoptions);
297 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
300 HREF="gnome-vfs-ops.html#GNOME-VFS-GET-FILE-INFO-URI"
301 >gnome_vfs_get_file_info_uri</A
304 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
307 GnomeVFSFileInfoOptionsoptions);
309 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
312 HREF="gnome-vfs-ops.html#GNOME-VFS-GET-FILE-INFO-FROM-HANDLE"
313 >gnome_vfs_get_file_info_from_handle</A
315 (GnomeVFSHandle *handle,
317 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
320 GnomeVFSFileInfoOptionsoptions);
322 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
325 HREF="gnome-vfs-ops.html#GNOME-VFS-TRUNCATE"
326 >gnome_vfs_truncate</A
328 HREF=../glib/glib-basic-types.html#GCHAR
329 >gchar</A> *text_uri,
331 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
335 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
338 HREF="gnome-vfs-ops.html#GNOME-VFS-TRUNCATE-URI"
339 >gnome_vfs_truncate_uri</A
342 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
346 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
349 HREF="gnome-vfs-ops.html#GNOME-VFS-TRUNCATE-HANDLE"
350 >gnome_vfs_truncate_handle</A
351 > (GnomeVFSHandle *handle,
353 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
357 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
360 HREF="gnome-vfs-ops.html#GNOME-VFS-MAKE-DIRECTORY-FOR-URI"
361 >gnome_vfs_make_directory_for_uri</A
365 HREF=../glib/glib-basic-types.html#GUINT
368 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
371 HREF="gnome-vfs-ops.html#GNOME-VFS-MAKE-DIRECTORY"
372 >gnome_vfs_make_directory</A
374 HREF=../glib/glib-basic-types.html#GCHAR
375 >gchar</A> *text_uri,
377 HREF=../glib/glib-basic-types.html#GUINT
380 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
383 HREF="gnome-vfs-ops.html#GNOME-VFS-REMOVE-DIRECTORY-FROM-URI"
384 >gnome_vfs_remove_directory_from_uri</A
388 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
391 HREF="gnome-vfs-ops.html#GNOME-VFS-REMOVE-DIRECTORY"
392 >gnome_vfs_remove_directory</A
394 HREF=../glib/glib-basic-types.html#GCHAR
395 >gchar</A> *text_uri);
397 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
400 HREF="gnome-vfs-ops.html#GNOME-VFS-UNLINK-FROM-URI"
401 >gnome_vfs_unlink_from_uri</A
402 > (GnomeVFSURI *uri);
404 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
407 HREF="gnome-vfs-ops.html#GNOME-VFS-CREATE-SYMBOLIC-LINK"
408 >gnome_vfs_create_symbolic_link</A
412 HREF=../glib/glib-basic-types.html#GCHAR
413 >gchar</A> *target_reference);
415 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
418 HREF="gnome-vfs-ops.html#GNOME-VFS-UNLINK"
421 HREF=../glib/glib-basic-types.html#GCHAR
422 >gchar</A> *text_uri);
424 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
427 HREF="gnome-vfs-ops.html#GNOME-VFS-MOVE-URI"
428 >gnome_vfs_move_uri</A
429 > (GnomeVFSURI *old_uri,
430 GnomeVFSURI *new_uri,
432 HREF=../glib/glib-basic-types.html#GBOOLEAN
433 >gboolean</A> force_replace);
435 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
438 HREF="gnome-vfs-ops.html#GNOME-VFS-MOVE"
441 HREF=../glib/glib-basic-types.html#GCHAR
442 >gchar</A> *old_text_uri,
444 HREF=../glib/glib-basic-types.html#GCHAR
445 >gchar</A> *new_text_uri,
447 HREF=../glib/glib-basic-types.html#GBOOLEAN
448 >gboolean</A> force_replace);
450 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
453 HREF="gnome-vfs-ops.html#GNOME-VFS-CHECK-SAME-FS-URIS"
454 >gnome_vfs_check_same_fs_uris</A
455 > (GnomeVFSURI *source_uri,
456 GnomeVFSURI *target_uri,
458 HREF=../glib/glib-basic-types.html#GBOOLEAN
459 >gboolean</A> *same_fs_return);
461 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
464 HREF="gnome-vfs-ops.html#GNOME-VFS-CHECK-SAME-FS"
465 >gnome_vfs_check_same_fs</A
467 HREF=../glib/glib-basic-types.html#GCHAR
470 HREF=../glib/glib-basic-types.html#GCHAR
473 HREF=../glib/glib-basic-types.html#GBOOLEAN
474 >gboolean</A> *same_fs_return);
476 HREF=../glib/glib-basic-types.html#GBOOLEAN
478 HREF="gnome-vfs-ops.html#GNOME-VFS-URI-EXISTS"
479 >gnome_vfs_uri_exists</A
480 > (GnomeVFSURI *uri);
482 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
485 HREF="gnome-vfs-ops.html#GNOME-VFS-SET-FILE-INFO-URI"
486 >gnome_vfs_set_file_info_uri</A
489 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
493 HREF="gnome-vfs-types.html#GNOMEVFSSETFILEINFOMASK"
494 >GnomeVFSSetFileInfoMask</A
497 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
500 HREF="gnome-vfs-ops.html#GNOME-VFS-SET-FILE-INFO"
501 >gnome_vfs_set_file_info</A
503 HREF=../glib/glib-basic-types.html#GCHAR
504 >gchar</A> *text_uri,
506 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
510 HREF="gnome-vfs-types.html#GNOMEVFSSETFILEINFOMASK"
511 >GnomeVFSSetFileInfoMask</A
541 NAME="GNOME-VFS-OPEN"
543 >gnome_vfs_open ()</H3
552 CLASS="PROGRAMLISTING"
554 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
556 > gnome_vfs_open (GnomeVFSHandle **handle,
558 HREF=../glib/glib-basic-types.html#GCHAR
559 >gchar</A> *text_uri,
561 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
573 > according to mode <TT
578 >. On return, @*handle will then
579 contain a pointer to a handle for the open file.</P
583 CLASS="INFORMALTABLE"
612 > A pointer to a pointer to a GnomeVFSHandle object</TD
629 > String representing the URI to open</TD
661 > An integer representing the result of the operation</TD
676 NAME="GNOME-VFS-OPEN-URI"
678 >gnome_vfs_open_uri ()</H3
687 CLASS="PROGRAMLISTING"
689 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
691 > gnome_vfs_open_uri (GnomeVFSHandle **handle,
694 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
706 > according to mode <TT
711 >. On return, @*handle will then
712 contain a pointer to a handle for the open file.</P
716 CLASS="INFORMALTABLE"
745 > A pointer to a pointer to a GnomeVFSHandle object</TD
794 > An integer representing the result of the operation</TD
809 NAME="GNOME-VFS-CREATE"
811 >gnome_vfs_create ()</H3
820 CLASS="PROGRAMLISTING"
822 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
824 > gnome_vfs_create (GnomeVFSHandle **handle,
826 HREF=../glib/glib-basic-types.html#GCHAR
827 >gchar</A> *text_uri,
829 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
833 HREF=../glib/glib-basic-types.html#GBOOLEAN
834 >gboolean</A> exclusive,
836 HREF=../glib/glib-basic-types.html#GUINT
837 >guint</A> perm);</PRE
847 > according to mode <TT
852 >. On return, @*handle will then
853 contain a pointer to a handle for the open file.</P
857 CLASS="INFORMALTABLE"
886 > A pointer to a pointer to a GnomeVFSHandle object</TD
903 > String representing the URI to create</TD
937 > Whether the file should be created in "exclusive" mode:
938 i.e. if this flag is nonzero, operation will fail if a file with the
939 same name already exists.</TD
956 > Bitmap representing the permissions for the newly created file
972 > An integer representing the result of the operation</TD
987 NAME="GNOME-VFS-CREATE-URI"
989 >gnome_vfs_create_uri ()</H3
998 CLASS="PROGRAMLISTING"
1000 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1002 > gnome_vfs_create_uri (GnomeVFSHandle **handle,
1005 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
1006 >GnomeVFSOpenMode</A
1009 HREF=../glib/glib-basic-types.html#GBOOLEAN
1010 >gboolean</A> exclusive,
1012 HREF=../glib/glib-basic-types.html#GUINT
1013 >guint</A> perm);</PRE
1023 > according to mode <TT
1028 >. On return, @*handle will then
1029 contain a pointer to a handle for the open file.</P
1033 CLASS="INFORMALTABLE"
1062 > A pointer to a pointer to a GnomeVFSHandle object</TD
1079 > URI for the file to create</TD
1113 > Whether the file should be created in "exclusive" mode:
1114 i.e. if this flag is nonzero, operation will fail if a file with the
1115 same name already exists.</TD
1132 > Bitmap representing the permissions for the newly created file
1148 > An integer representing the result of the operation</TD
1163 NAME="GNOME-VFS-CLOSE"
1165 >gnome_vfs_close ()</H3
1174 CLASS="PROGRAMLISTING"
1176 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1178 > gnome_vfs_close (GnomeVFSHandle *handle);</PRE
1183 >Close file associated with <TT
1192 CLASS="INFORMALTABLE"
1221 > A pointer to a GnomeVFSHandle object</TD
1236 > An integer representing the result of the operation.</TD
1251 NAME="GNOME-VFS-READ"
1253 >gnome_vfs_read ()</H3
1262 CLASS="PROGRAMLISTING"
1264 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1266 > gnome_vfs_read (GnomeVFSHandle *handle,
1268 HREF=../glib/glib-basic-types.html#GPOINTER
1269 >gpointer</A> buffer,
1271 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1272 >GnomeVFSFileSize</A
1275 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1276 >GnomeVFSFileSize</A
1277 > *bytes_read);</PRE
1292 >. As with Unix system calls, the number of
1293 bytes read can effectively be less than <TT
1298 > on return and will be
1299 stored in @*bytes_read.</P
1303 CLASS="INFORMALTABLE"
1332 > Handle of the file to read data from</TD
1349 > Pointer to a buffer that must be at least <TT
1371 > Number of bytes to read</TD
1388 > Pointer to a variable that will hold the number of bytes
1389 effectively read on return.</TD
1404 > An integer representing the result of the operation</TD
1419 NAME="GNOME-VFS-WRITE"
1421 >gnome_vfs_write ()</H3
1430 CLASS="PROGRAMLISTING"
1432 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1434 > gnome_vfs_write (GnomeVFSHandle *handle,
1436 HREF=../glib/glib-basic-types.html#GCONSTPOINTER
1437 >gconstpointer</A> buffer,
1439 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1440 >GnomeVFSFileSize</A
1443 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1444 >GnomeVFSFileSize</A
1445 > *bytes_written);</PRE
1455 > into the file opened through <TT
1460 >. As with Unix system
1461 calls, the number of bytes written can effectively be less than <TT
1467 return and will be stored in @*bytes_written.</P
1471 CLASS="INFORMALTABLE"
1500 > Handle of the file to write data to</TD
1517 > Pointer to the buffer containing the data to be written</TD
1534 > Number of bytes to write</TD
1566 > An integer representing the result of the operation</TD
1581 NAME="GNOME-VFS-SEEK"
1583 >gnome_vfs_seek ()</H3
1592 CLASS="PROGRAMLISTING"
1594 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1596 > gnome_vfs_seek (GnomeVFSHandle *handle,
1598 HREF="gnome-vfs-types.html#GNOMEVFSSEEKPOSITION"
1599 >GnomeVFSSeekPosition</A
1602 HREF="gnome-vfs-file-size.html#GNOMEVFSFILEOFFSET"
1603 >GnomeVFSFileOffset</A
1609 >Set the current position for reading/writing through <TT
1618 CLASS="INFORMALTABLE"
1647 > Handle for which the current position must be changed</TD
1664 > Integer value representing the starting position</TD
1681 > Number of bytes to skip from the position specified by <TT
1687 (a positive value means to move forward; a negative one to move backwards)</TD
1717 NAME="GNOME-VFS-TELL"
1719 >gnome_vfs_tell ()</H3
1728 CLASS="PROGRAMLISTING"
1730 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1732 > gnome_vfs_tell (GnomeVFSHandle *handle,
1734 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
1735 >GnomeVFSFileSize</A
1736 > *offset_return);</PRE
1741 >Return the current position on <TT
1750 CLASS="INFORMALTABLE"
1779 > Handle for which the current position must be retrieved</TD
1796 > Pointer to a variable that will contain the current position
1812 > An integer representing the result of the operation</TD
1827 NAME="GNOME-VFS-GET-FILE-INFO"
1829 >gnome_vfs_get_file_info ()</H3
1838 CLASS="PROGRAMLISTING"
1840 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1842 > gnome_vfs_get_file_info (const <A
1843 HREF=../glib/glib-basic-types.html#GCHAR
1844 >gchar</A> *text_uri,
1846 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
1847 >GnomeVFSFileInfo</A
1849 GnomeVFSFileInfoOptionsoptions);</PRE
1854 >Retrieve information about <TT
1859 >. The information will be stored in
1864 CLASS="INFORMALTABLE"
1893 > URI of the file for which information will be retrieved</TD
1910 > Pointer to a GnomeVFSFileInfo object that will hold the information
1911 for the file on return</TD
1943 > An integer representing the result of the operation</TD
1958 NAME="GNOME-VFS-GET-FILE-INFO-URI"
1960 >gnome_vfs_get_file_info_uri ()</H3
1969 CLASS="PROGRAMLISTING"
1971 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
1973 > gnome_vfs_get_file_info_uri (GnomeVFSURI *uri,
1975 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
1976 >GnomeVFSFileInfo</A
1978 GnomeVFSFileInfoOptionsoptions);</PRE
1983 >Retrieve information about <TT
1988 >. The information will be stored in
1998 CLASS="INFORMALTABLE"
2027 > URI of the file for which information will be retrieved</TD
2044 > Pointer to a GnomeVFSFileInfo object that will hold the information
2045 for the file on return</TD
2077 > An integer representing the result of the operation</TD
2092 NAME="GNOME-VFS-GET-FILE-INFO-FROM-HANDLE"
2094 >gnome_vfs_get_file_info_from_handle ()</H3
2103 CLASS="PROGRAMLISTING"
2105 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2107 > gnome_vfs_get_file_info_from_handle
2108 (GnomeVFSHandle *handle,
2110 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
2111 >GnomeVFSFileInfo</A
2113 GnomeVFSFileInfoOptionsoptions);</PRE
2118 >Retrieve information about an open file. The information will be stored in
2123 CLASS="INFORMALTABLE"
2152 > Handle of the file for which information must be retrieved</TD
2169 > Pointer to a GnomeVFSFileInfo object that will hold the information
2170 for the file on return</TD
2202 > An integer representing the result of the operation</TD
2217 NAME="GNOME-VFS-TRUNCATE"
2219 >gnome_vfs_truncate ()</H3
2228 CLASS="PROGRAMLISTING"
2230 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2232 > gnome_vfs_truncate (const <A
2233 HREF=../glib/glib-basic-types.html#GCHAR
2234 >gchar</A> *text_uri,
2236 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
2237 >GnomeVFSFileSize</A
2245 CLASS="INFORMALTABLE"
2321 NAME="GNOME-VFS-TRUNCATE-URI"
2323 >gnome_vfs_truncate_uri ()</H3
2332 CLASS="PROGRAMLISTING"
2334 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2336 > gnome_vfs_truncate_uri (GnomeVFSURI *uri,
2338 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
2339 >GnomeVFSFileSize</A
2347 CLASS="INFORMALTABLE"
2423 NAME="GNOME-VFS-TRUNCATE-HANDLE"
2425 >gnome_vfs_truncate_handle ()</H3
2434 CLASS="PROGRAMLISTING"
2436 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2438 > gnome_vfs_truncate_handle (GnomeVFSHandle *handle,
2440 HREF="gnome-vfs-file-size.html#GNOMEVFSFILESIZE"
2441 >GnomeVFSFileSize</A
2449 CLASS="INFORMALTABLE"
2525 NAME="GNOME-VFS-MAKE-DIRECTORY-FOR-URI"
2527 >gnome_vfs_make_directory_for_uri ()</H3
2536 CLASS="PROGRAMLISTING"
2538 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2540 > gnome_vfs_make_directory_for_uri
2543 HREF=../glib/glib-basic-types.html#GUINT
2544 >guint</A> perm);</PRE
2554 > as a directory.</P
2558 CLASS="INFORMALTABLE"
2587 > URI of the directory to be created</TD
2604 > Unix-style permissions for the newly created directory</TD
2619 > An integer representing the result of the operation</TD
2634 NAME="GNOME-VFS-MAKE-DIRECTORY"
2636 >gnome_vfs_make_directory ()</H3
2645 CLASS="PROGRAMLISTING"
2647 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2649 > gnome_vfs_make_directory (const <A
2650 HREF=../glib/glib-basic-types.html#GCHAR
2651 >gchar</A> *text_uri,
2653 HREF=../glib/glib-basic-types.html#GUINT
2654 >guint</A> perm);</PRE
2664 > as a directory.</P
2668 CLASS="INFORMALTABLE"
2697 > URI of the directory to be created</TD
2714 > Unix-style permissions for the newly created directory</TD
2729 > An integer representing the result of the operation</TD
2744 NAME="GNOME-VFS-REMOVE-DIRECTORY-FROM-URI"
2746 >gnome_vfs_remove_directory_from_uri ()</H3
2755 CLASS="PROGRAMLISTING"
2757 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2759 > gnome_vfs_remove_directory_from_uri
2760 (GnomeVFSURI *uri);</PRE
2775 > must be an empty directory.</P
2779 CLASS="INFORMALTABLE"
2808 > URI of the directory to be removed</TD
2823 > An integer representing the result of the operation</TD
2838 NAME="GNOME-VFS-REMOVE-DIRECTORY"
2840 >gnome_vfs_remove_directory ()</H3
2849 CLASS="PROGRAMLISTING"
2851 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2853 > gnome_vfs_remove_directory (const <A
2854 HREF=../glib/glib-basic-types.html#GCHAR
2855 >gchar</A> *text_uri);</PRE
2862 CLASS="INFORMALTABLE"
2921 NAME="GNOME-VFS-UNLINK-FROM-URI"
2923 >gnome_vfs_unlink_from_uri ()</H3
2932 CLASS="PROGRAMLISTING"
2934 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
2936 > gnome_vfs_unlink_from_uri (GnomeVFSURI *uri);</PRE
2950 CLASS="INFORMALTABLE"
2994 > An integer representing the result of the operation</TD
3009 NAME="GNOME-VFS-CREATE-SYMBOLIC-LINK"
3011 >gnome_vfs_create_symbolic_link ()</H3
3020 CLASS="PROGRAMLISTING"
3022 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3024 > gnome_vfs_create_symbolic_link
3027 HREF=../glib/glib-basic-types.html#GCHAR
3028 >gchar</A> *target_reference);</PRE
3033 >Creates a symbolic link, or eventually, a URI link (as necessary)
3042 >target_reference</I
3048 CLASS="INFORMALTABLE"
3077 > URI to create a link at</TD
3087 >target_reference</I
3094 > URI "reference" to point the link to (URI or relative path)</TD
3109 > An integer representing the result of the operation</TD
3124 NAME="GNOME-VFS-UNLINK"
3126 >gnome_vfs_unlink ()</H3
3135 CLASS="PROGRAMLISTING"
3137 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3139 > gnome_vfs_unlink (const <A
3140 HREF=../glib/glib-basic-types.html#GCHAR
3141 >gchar</A> *text_uri);</PRE
3148 CLASS="INFORMALTABLE"
3207 NAME="GNOME-VFS-MOVE-URI"
3209 >gnome_vfs_move_uri ()</H3
3218 CLASS="PROGRAMLISTING"
3220 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3222 > gnome_vfs_move_uri (GnomeVFSURI *old_uri,
3223 GnomeVFSURI *new_uri,
3225 HREF=../glib/glib-basic-types.html#GBOOLEAN
3226 >gboolean</A> force_replace);</PRE
3231 >Move a file from URI <TT
3241 >. This will only work if <TT
3252 > are on the same file system. Otherwise, it is necessary
3253 to use the more general %<A
3254 HREF="gnome-vfs-xfer.html#GNOME-VFS-XFER-URI"
3255 >gnome_vfs_xfer_uri</A
3260 CLASS="INFORMALTABLE"
3306 > Destination URI</TD
3338 > An integer representing the result of the operation.</TD
3353 NAME="GNOME-VFS-MOVE"
3355 >gnome_vfs_move ()</H3
3364 CLASS="PROGRAMLISTING"
3366 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3368 > gnome_vfs_move (const <A
3369 HREF=../glib/glib-basic-types.html#GCHAR
3370 >gchar</A> *old_text_uri,
3372 HREF=../glib/glib-basic-types.html#GCHAR
3373 >gchar</A> *new_text_uri,
3375 HREF=../glib/glib-basic-types.html#GBOOLEAN
3376 >gboolean</A> force_replace);</PRE
3381 >Move a file from URI <TT
3391 >. This will only work
3402 > are on the same file system. Otherwise,
3403 it is necessary to use the more general %<A
3404 HREF="gnome-vfs-xfer.html#GNOME-VFS-XFER-URI"
3405 >gnome_vfs_xfer_uri</A
3410 CLASS="INFORMALTABLE"
3456 > Destination URI</TD
3488 > An integer representing the result of the operation.</TD
3503 NAME="GNOME-VFS-CHECK-SAME-FS-URIS"
3505 >gnome_vfs_check_same_fs_uris ()</H3
3514 CLASS="PROGRAMLISTING"
3516 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3518 > gnome_vfs_check_same_fs_uris (GnomeVFSURI *source_uri,
3519 GnomeVFSURI *target_uri,
3521 HREF=../glib/glib-basic-types.html#GBOOLEAN
3522 >gboolean</A> *same_fs_return);</PRE
3537 > are on the same file system.</P
3541 CLASS="INFORMALTABLE"
3604 > Pointer to a boolean variable which will be set to <TT
3618 > are on the same file system on return.</TD
3633 > An integer representing the result of the operation.</TD
3648 NAME="GNOME-VFS-CHECK-SAME-FS"
3650 >gnome_vfs_check_same_fs ()</H3
3659 CLASS="PROGRAMLISTING"
3661 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3663 > gnome_vfs_check_same_fs (const <A
3664 HREF=../glib/glib-basic-types.html#GCHAR
3667 HREF=../glib/glib-basic-types.html#GCHAR
3670 HREF=../glib/glib-basic-types.html#GBOOLEAN
3671 >gboolean</A> *same_fs_return);</PRE
3686 > are on the same file system.</P
3690 CLASS="INFORMALTABLE"
3753 > Pointer to a boolean variable which will be set to <TT
3767 > are on the same file system on return.</TD
3782 > An integer representing the result of the operation.</TD
3797 NAME="GNOME-VFS-URI-EXISTS"
3799 >gnome_vfs_uri_exists ()</H3
3808 CLASS="PROGRAMLISTING"
3810 HREF=../glib/glib-basic-types.html#GBOOLEAN
3811 >gboolean</A> gnome_vfs_uri_exists (GnomeVFSURI *uri);</PRE
3816 >Check if the URI points to an existing entity.</P
3820 CLASS="INFORMALTABLE"
3864 > TRUE if URI exists.</TD
3879 NAME="GNOME-VFS-SET-FILE-INFO-URI"
3881 >gnome_vfs_set_file_info_uri ()</H3
3890 CLASS="PROGRAMLISTING"
3892 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3894 > gnome_vfs_set_file_info_uri (GnomeVFSURI *uri,
3896 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
3897 >GnomeVFSFileInfo</A
3900 HREF="gnome-vfs-types.html#GNOMEVFSSETFILEINFOMASK"
3901 >GnomeVFSSetFileInfoMask</A
3907 >Set file information for <TT
3912 >; only the information for which the
3913 corresponding bit in <TT
3918 > is set is actually modified.</P
3922 CLASS="INFORMALTABLE"
3968 > Information that must be set for the file</TD
3985 > Bit mask representing which fields of <TT
3990 > need to be set </TD
4005 > An integer representing the result of the operation.</TD
4020 NAME="GNOME-VFS-SET-FILE-INFO"
4022 >gnome_vfs_set_file_info ()</H3
4031 CLASS="PROGRAMLISTING"
4033 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
4035 > gnome_vfs_set_file_info (const <A
4036 HREF=../glib/glib-basic-types.html#GCHAR
4037 >gchar</A> *text_uri,
4039 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
4040 >GnomeVFSFileInfo</A
4043 HREF="gnome-vfs-types.html#GNOMEVFSSETFILEINFOMASK"
4044 >GnomeVFSSetFileInfoMask</A
4050 >Set file information for <TT
4055 >; only the information for which the
4056 corresponding bit in <TT
4061 > is set is actually modified.</P
4065 CLASS="INFORMALTABLE"
4111 > Information that must be set for the file</TD
4128 > Bit mask representing which fields of <TT
4133 > need to be set </TD
4148 > An integer representing the result of the operation.</TD
4160 CLEAR="all"><BR><TABLE
4172 HREF="file-operations.html"
4177 ><<< Previous Page</B
4210 HREF="file-operations.html"
4226 HREF="gnome-vfs-directory.html"
4231 >Next Page >>></B
4244 >Basic File Operations</B
4254 >Directory Operations</B