Lines Matching refs:GFile
31 #include "gfile.h"
49 * SECTION:gfile
54 * #GFile is a high level abstraction for manipulating files on a
55 * virtual file system. #GFile<!-- -->s are lightweight, immutable
57 * #GFile objects do not represent files, merely an identifier for a file. All
61 * To construct a #GFile, you can use:
67 * One way to think of a #GFile is as an abstraction of a pathname. For normal
68 * files the system pathname is what is stored internally, but as #GFile<!-- -->s
72 * #GFile<!-- -->s make up hierarchies of directories and files that correspond to the
73 * files on a filesystem. You can move through the file system with #GFile using
76 * path between two #GFile<!-- -->s. There can be multiple hierarchies, so you may not
80 * All #GFile<!-- -->s have a basename (get with g_file_get_basename()). These names
87 * store the real basename or the #GFile to use to actually access the file, because
90 * Using #GFile as an identifier has the same weaknesses as using a path in that
92 * soft links may cause two different #GFile<!-- -->s to refer to the same file.
95 * two #GFile<!-- -->s point to the same file you can query for the
96 * %G_FILE_ATTRIBUTE_ID_FILE attribute. Note that #GFile does some trivial
99 * or ".." path segments, etc) does not create different #GFile<!-- -->s.
101 * Many #GFile operations have both synchronous and asynchronous versions
108 * Some #GFile operations do not have synchronous analogs, as they may
115 * <para id="gfile-etag"><indexterm><primary>entity tag</primary></indexterm>
116 * One notable feature of #GFile<!-- -->s are entity tags, or "etags" for
129 static void g_file_real_query_info_async (GFile *file,
136 static GFileInfo * g_file_real_query_info_finish (GFile *file,
139 static void g_file_real_query_filesystem_info_async (GFile *file,
145 static GFileInfo * g_file_real_query_filesystem_info_finish (GFile *file,
148 static void g_file_real_enumerate_children_async (GFile *file,
155 static GFileEnumerator * g_file_real_enumerate_children_finish (GFile *file,
158 static void g_file_real_read_async (GFile *file,
163 static GFileInputStream * g_file_real_read_finish (GFile *file,
166 static void g_file_real_append_to_async (GFile *file,
172 static GFileOutputStream *g_file_real_append_to_finish (GFile *file,
175 static void g_file_real_create_async (GFile *file,
181 static GFileOutputStream *g_file_real_create_finish (GFile *file,
184 static void g_file_real_replace_async (GFile *file,
192 static GFileOutputStream *g_file_real_replace_finish (GFile *file,
195 static gboolean g_file_real_set_attributes_from_info (GFile *file,
200 static void g_file_real_set_display_name_async (GFile *file,
206 static GFile * g_file_real_set_display_name_finish (GFile *file,
209 static void g_file_real_set_attributes_async (GFile *file,
216 static gboolean g_file_real_set_attributes_finish (GFile *file,
220 static void g_file_real_find_enclosing_mount_async (GFile *file,
225 static GMount * g_file_real_find_enclosing_mount_finish (GFile *file,
228 static void g_file_real_copy_async (GFile *source,
229 GFile *destination,
237 static gboolean g_file_real_copy_finish (GFile *file,
261 g_type_register_static (G_TYPE_INTERFACE, I_("GFile"),
311 * @file: input #GFile.
329 g_file_is_native (GFile *file)
343 * @file: input #GFile.
346 * Checks to see if a #GFile has a given URI scheme.
350 * Returns: %TRUE if #GFile's backend supports the
352 * not supported, or #GFile is invalid.
355 g_file_has_uri_scheme (GFile *file,
371 * @file: input #GFile.
373 * Gets the URI scheme for a #GFile.
383 * #GFile. The returned string should be freed with g_free()
387 g_file_get_uri_scheme (GFile *file)
401 * @file: input #GFile.
403 * Gets the base name (the last component of the path) for a given #GFile.
417 * Returns: string containing the #GFile's base name, or %NULL
418 * if given #GFile is invalid. The returned string should be
422 g_file_get_basename (GFile *file)
435 * @file: input #GFile.
437 * Gets the local pathname for #GFile, if one exists.
441 * Returns: string containing the #GFile's path, or %NULL if
446 g_file_get_path (GFile *file)
459 * @file: input #GFile.
465 * Returns: a string containing the #GFile's URI.
469 g_file_get_uri (GFile *file)
482 * @file: input #GFile.
486 * file such that one can get the #GFile back using
489 * This is generally used to show the #GFile as a nice
499 * Returns: a string containing the #GFile's parse name. The returned
503 g_file_get_parse_name (GFile *file)
516 * @file: input #GFile.
518 * Duplicates a #GFile handle. This operation does not duplicate
519 * the actual file or directory represented by the #GFile; see
524 * Returns: a new #GFile that is a duplicate of the given #GFile.
526 GFile *
527 g_file_dup (GFile *file)
540 * @file: #gconstpointer to a #GFile.
542 * Creates a hash value for a #GFile.
546 * Returns: 0 if @file is not a valid #GFile, otherwise an
547 * integer that can be used as hash value for the #GFile.
548 * This function is intended for easily hashing a #GFile to
560 return (* iface->hash) ((GFile *)file);
565 * @file1: the first #GFile.
566 * @file2: the second #GFile.
568 * Checks equality of two given #GFile<!-- -->s. Note that two
569 * #GFile<!-- -->s that differ can still refer to the same
576 * %FALSE if either is not a #GFile.
579 g_file_equal (GFile *file1,
580 GFile *file2)
598 * @file: input #GFile.
606 * Returns: a #GFile structure to the parent of the given
607 * #GFile or %NULL if there is no parent.
610 GFile *
611 g_file_get_parent (GFile *file)
624 * @file: input #GFile.
630 * you can still have a #GFile that points to it. You can use this
635 * Returns: a #GFile to a child specified by @name.
638 GFile *
639 g_file_get_child (GFile *file,
650 * @file: input #GFile.
656 * set. This is very useful when constructing a GFile for a new file
662 * Returns: a #GFile to the specified child, or
666 GFile *
667 g_file_get_child_for_display_name (GFile *file,
683 * @file: input #GFile.
684 * @prefix: input #GFile.
700 g_file_has_prefix (GFile *file,
701 GFile *prefix)
720 * @parent: input #GFile.
721 * @descendant: input #GFile.
732 g_file_get_relative_path (GFile *parent,
733 GFile *descendant)
750 * @file: input #GFile.
757 * Returns: #GFile to the resolved path. %NULL if @relative_path
761 GFile *
762 g_file_resolve_relative_path (GFile *file,
777 * @file: input #GFile.
807 g_file_enumerate_children (GFile *file,
837 * @file: input #GFile.
857 g_file_enumerate_children_async (GFile *file,
881 * @file: input #GFile.
892 g_file_enumerate_children_finish (GFile *file,
914 * @file: input #GFile.
943 g_file_query_exists (GFile *file,
963 * @file: input #GFile.
979 g_file_query_file_type (GFile *file,
1002 * @file: input #GFile.
1038 g_file_query_info (GFile *file,
1066 * @file: input #GFile.
1086 g_file_query_info_async (GFile *file,
1110 * @file: input #GFile.
1121 g_file_query_info_finish (GFile *file,
1143 * @file: input #GFile.
1174 g_file_query_filesystem_info (GFile *file,
1201 * @file: input #GFile.
1222 g_file_query_filesystem_info_async (GFile *file,
1244 * @file: input #GFile.
1255 g_file_query_filesystem_info_finish (GFile *file,
1277 * @file: input #GFile.
1281 * Gets a #GMount for the #GFile.
1295 g_file_find_enclosing_mount (GFile *file,
1322 * @file: a #GFile
1338 g_file_find_enclosing_mount_async (GFile *file,
1358 * @file: a #GFile
1369 g_file_find_enclosing_mount_finish (GFile *file,
1392 * @file: #GFile to read.
1411 g_file_read (GFile *file,
1437 GFile.
1464 g_file_append_to (GFile *file,
1491 * @file: input #GFile.
1521 g_file_create (GFile *file,
1548 * @file: input #GFile.
1549 * @etag: an optional <link linkend="gfile-etag">entity tag</link> for the
1550 * current #GFile, or #NULL to ignore.
1602 g_file_replace (GFile *file,
1636 * @file: input #GFile.
1652 g_file_read_async (GFile *file,
1672 * @file: input #GFile.
1683 g_file_read_finish (GFile *file,
1705 * @file: input #GFile.
1722 g_file_append_to_async (GFile *file,
1744 * @file: input #GFile.
1755 g_file_append_to_finish (GFile *file,
1777 * @file: input #GFile.
1795 g_file_create_async (GFile *file,
1817 * @file: input #GFile.
1828 g_file_create_finish (GFile *file,
1850 * @file: input #GFile.
1851 * @etag: an <link linkend="gfile-etag">entity tag</link> for the
1852 * current #GFile, or NULL to ignore.
1871 g_file_replace_async (GFile *file,
1897 * @file: input #GFile.
1908 g_file_replace_finish (GFile *file,
1929 copy_symlink (GFile *destination,
1985 open_source_for_copy (GFile *source,
1986 GFile *destination,
2123 * @source: a #GFile with attributes.
2124 * @destination: a #GFile to copy attributes to.
2141 g_file_copy_attributes (GFile *source,
2142 GFile *destination,
2199 GFile *source,
2298 file_copy_fallback (GFile *source,
2299 GFile *destination,
2393 * @source: input #GFile.
2394 * @destination: destination #GFile
2435 * If you are interested in copying the #GFile object itself (not the on-disk
2441 g_file_copy (GFile *source,
2442 GFile *destination,
2514 * @source: input #GFile.
2515 * @destination: destination #GFile
2536 g_file_copy_async (GFile *source,
2537 GFile *destination,
2565 * @file: input #GFile.
2575 g_file_copy_finish (GFile *file,
2598 * @source: #GFile pointing to the source location.
2599 * @destination: #GFile pointing to the destination location.
2646 g_file_move (GFile *source,
2647 GFile *destination,
2727 * @file: input #GFile.
2732 * the immediate parent directory of the path or URI given by the #GFile. To
2739 * For a local #GFile the newly created directory will have the default
2749 g_file_make_directory (GFile *file,
2775 * @file: input #GFile.
2783 * For a local #GFile the newly created directories will have the default
2796 g_file_make_directory_with_parents (GFile *file,
2801 GFile *parent_file, *work_file;
2835 result = g_file_make_directory ((GFile *) l->data, cancellable, &my_error);
2841 g_object_unref ((GFile *) list->data);
2856 * @file: input #GFile.
2870 g_file_make_symbolic_link (GFile *file,
2906 * @file: input #GFile.
2920 g_file_delete (GFile *file,
2946 * @file: #GFile to send to trash.
2963 g_file_trash (GFile *file,
2989 * @file: input #GFile.
3009 * Returns: a #GFile specifying what @file was renamed to, or %NULL
3013 GFile *
3014 g_file_set_display_name (GFile *file,
3043 * @file: input #GFile.
3051 * Asynchronously sets the display name for a given #GFile.
3060 g_file_set_display_name_async (GFile *file,
3083 * @file: input #GFile.
3090 * Returns: a #GFile or %NULL on error.
3093 GFile *
3094 g_file_set_display_name_finish (GFile *file,
3116 * @file: input #GFile.
3135 g_file_query_settable_attributes (GFile *file,
3172 * @file: input #GFile.
3188 g_file_query_writable_namespaces (GFile *file,
3225 * @file: input #GFile.
3242 g_file_set_attribute (GFile *file,
3273 * @file: input #GFile.
3295 g_file_set_attributes_from_info (GFile *file,
3322 g_file_real_set_attributes_from_info (GFile *file,
3364 * @file: input #GFile.
3382 g_file_set_attributes_async (GFile *file,
3407 * @file: input #GFile.
3417 g_file_set_attributes_finish (GFile *file,
3436 * @file: input #GFile.
3453 g_file_set_attribute_string (GFile *file,
3467 * @file: input #GFile.
3486 g_file_set_attribute_byte_string (GFile *file,
3500 * @file: input #GFile.
3518 g_file_set_attribute_uint32 (GFile *file,
3532 * @file: input #GFile.
3550 g_file_set_attribute_int32 (GFile *file,
3564 * @file: input #GFile.
3582 g_file_set_attribute_uint64 (GFile *file,
3596 * @file: input #GFile.
3613 g_file_set_attribute_int64 (GFile *file,
3627 * @file: input #GFile.
3646 g_file_mount_mountable (GFile *file,
3680 * @file: input #GFile.
3689 * Returns: a #GFile or %NULL on error.
3692 GFile *
3693 g_file_mount_mountable_finish (GFile *file,
3715 * @file: input #GFile.
3731 g_file_unmount_mountable (GFile *file,
3763 * @file: input #GFile.
3776 g_file_unmount_mountable_finish (GFile *file,
3798 * @file: input #GFile.
3814 g_file_eject_mountable (GFile *file,
3846 * @file: input #GFile.
3857 g_file_eject_mountable_finish (GFile *file,
3879 * @file: input #GFile.
3895 g_file_monitor_directory (GFile *file,
3922 * @file: input #GFile.
3938 g_file_monitor_file (GFile *file,
3967 * @file: input #GFile
3985 g_file_monitor (GFile *file,
4038 g_file_real_query_info_async (GFile *file,
4061 g_file_real_query_info_finish (GFile *file,
4114 g_file_real_query_filesystem_info_async (GFile *file,
4135 g_file_real_query_filesystem_info_finish (GFile *file,
4189 g_file_real_enumerate_children_async (GFile *file,
4212 g_file_real_enumerate_children_finish (GFile *file,
4263 g_file_real_read_async (GFile *file,
4278 g_file_real_read_finish (GFile *file,
4320 g_file_real_append_to_async (GFile *file,
4341 g_file_real_append_to_finish (GFile *file,
4383 g_file_real_create_async (GFile *file,
4404 g_file_real_create_finish (GFile *file,
4467 g_file_real_replace_async (GFile *file,
4492 g_file_real_replace_finish (GFile *file,
4510 GFile *file;
4529 GFile *file;
4545 g_file_real_set_display_name_async (GFile *file,
4565 static GFile *
4566 g_file_real_set_display_name_finish (GFile *file,
4617 g_file_real_set_attributes_async (GFile *file,
4640 g_file_real_set_attributes_finish (GFile *file,
4681 g_file_real_find_enclosing_mount_async (GFile *file,
4696 g_file_real_find_enclosing_mount_finish (GFile *file,
4711 GFile *source;
4712 GFile *destination;
4815 g_file_real_copy_async (GFile *source,
4816 GFile *destination,
4842 g_file_real_copy_finish (GFile *file,
4859 * Constructs a #GFile for a given path. This operation never
4863 * Returns: a new #GFile for the given @path.
4865 GFile *
4877 * Constructs a #GFile for a given URI. This operation never
4882 * Returns: a #GFile for the given @uri.
4884 GFile *
4896 * Constructs a #GFile with the given @parse_name (i.e. something given by g_file_get_parse_name()).
4900 * Returns: a new #GFile.
4902 GFile *
4940 * Creates a #GFile with the given argument from the command line. The value of
4946 * Returns: a new #GFile.
4948 GFile *
4951 GFile *file;
4975 * @location: input #GFile.
4993 g_file_mount_enclosing_volume (GFile *location,
5022 * @location: input #GFile.
5033 g_file_mount_enclosing_volume_finish (GFile *location,
5060 * @file: a #GFile to open.
5075 g_file_query_default_handler (GFile *file,
5129 * @file: input #GFile.
5151 g_file_load_contents (GFile *file,
5222 GFile *file;
5353 GFile *file = G_FILE (obj);
5389 * @file: input #GFile.
5408 g_file_load_partial_contents_async (GFile *file,
5437 * @file: input #GFile.
5456 g_file_load_partial_contents_finish (GFile *file,
5510 * @file: input #GFile.
5530 g_file_load_contents_async (GFile *file,
5543 * @file: input #GFile.
5562 g_file_load_contents_finish (GFile *file,
5579 * @file: input #GFile.
5582 * @etag: the old <link linkend="gfile-etag">entity tag</link>
5586 * @new_etag: a location to a new <link linkend="gfile-etag">entity tag</link>
5611 g_file_replace_contents (GFile *file,
5667 GFile *file;
5759 GFile *file = G_FILE (obj);
5793 * @file: input #GFile.
5796 * @etag: a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL
5819 g_file_replace_contents_async (GFile *file,
5857 * @file: input #GFile.
5859 * @new_etag: a location of a new <link linkend="gfile-etag">entity tag</link>
5871 GFile *file,
