mirror of
https://gitlab.gnome.org/GNOME/nautilus
synced 2024-11-05 16:04:31 +00:00
368 lines
10 KiB
C
368 lines
10 KiB
C
/*
|
|
* nautilus-file-info.c - Information about a file
|
|
*
|
|
* Copyright (C) 2003 Novell, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the Free
|
|
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*
|
|
*/
|
|
|
|
#include <config.h>
|
|
#include "nautilus-file-info.h"
|
|
#include "nautilus-extension-private.h"
|
|
|
|
NautilusFileInfo *(*nautilus_file_info_getter) (GFile *location, gboolean create);
|
|
|
|
/**
|
|
* nautilus_file_info_list_copy:
|
|
* @files: (element-type NautilusFileInfo): the files to copy
|
|
*
|
|
* Returns: (element-type NautilusFileInfo) (transfer full): a copy of @files.
|
|
* Use #nautilus_file_info_list_free to free the list and unref its contents.
|
|
*/
|
|
GList *
|
|
nautilus_file_info_list_copy (GList *files)
|
|
{
|
|
GList *ret;
|
|
GList *l;
|
|
|
|
ret = g_list_copy (files);
|
|
for (l = ret; l != NULL; l = l->next) {
|
|
g_object_ref (G_OBJECT (l->data));
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_list_free:
|
|
* @files: (element-type NautilusFileInfo): a list created with
|
|
* #nautilus_file_info_list_copy
|
|
*
|
|
*/
|
|
void
|
|
nautilus_file_info_list_free (GList *files)
|
|
{
|
|
GList *l;
|
|
|
|
for (l = files; l != NULL; l = l->next) {
|
|
g_object_unref (G_OBJECT (l->data));
|
|
}
|
|
|
|
g_list_free (files);
|
|
}
|
|
|
|
static void
|
|
nautilus_file_info_base_init (gpointer g_class)
|
|
{
|
|
}
|
|
|
|
GType
|
|
nautilus_file_info_get_type (void)
|
|
{
|
|
static GType type = 0;
|
|
|
|
if (!type) {
|
|
const GTypeInfo info = {
|
|
sizeof (NautilusFileInfoIface),
|
|
nautilus_file_info_base_init,
|
|
NULL,
|
|
NULL,
|
|
NULL,
|
|
NULL,
|
|
0,
|
|
0,
|
|
NULL
|
|
};
|
|
|
|
type = g_type_register_static (G_TYPE_INTERFACE,
|
|
"NautilusFileInfo",
|
|
&info, 0);
|
|
g_type_interface_add_prerequisite (type, G_TYPE_OBJECT);
|
|
}
|
|
|
|
return type;
|
|
}
|
|
|
|
gboolean
|
|
nautilus_file_info_is_gone (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), FALSE);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->is_gone != NULL, FALSE);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->is_gone (file);
|
|
}
|
|
|
|
GFileType
|
|
nautilus_file_info_get_file_type (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), G_FILE_TYPE_UNKNOWN);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_file_type != NULL, G_FILE_TYPE_UNKNOWN);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_file_type (file);
|
|
}
|
|
|
|
char *
|
|
nautilus_file_info_get_name (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_name != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_name (file);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_get_location:
|
|
* @file: a #NautilusFileInfo
|
|
*
|
|
* Returns: (transfer full): a #GFile for the location of @file
|
|
*/
|
|
GFile *
|
|
nautilus_file_info_get_location (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_location != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_location (file);
|
|
}
|
|
char *
|
|
nautilus_file_info_get_uri (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_uri != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_uri (file);
|
|
}
|
|
|
|
char *
|
|
nautilus_file_info_get_activation_uri (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_activation_uri != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_activation_uri (file);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_get_parent_location:
|
|
* @file: a #NautilusFileInfo
|
|
*
|
|
* Returns: (allow-none) (transfer full): a #GFile for the parent location of @file,
|
|
* or %NULL if @file has no parent
|
|
*/
|
|
GFile *
|
|
nautilus_file_info_get_parent_location (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_parent_location != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_parent_location (file);
|
|
}
|
|
|
|
char *
|
|
nautilus_file_info_get_parent_uri (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_parent_uri != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_parent_uri (file);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_get_parent_info:
|
|
* @file: a #NautilusFileInfo
|
|
*
|
|
* Returns: (allow-none) (transfer full): a #NautilusFileInfo for the parent of @file,
|
|
* or %NULL if @file has no parent
|
|
*/
|
|
NautilusFileInfo *
|
|
nautilus_file_info_get_parent_info (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_parent_info != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_parent_info (file);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_get_mount:
|
|
* @file: a #NautilusFileInfo
|
|
*
|
|
* Returns: (allow-none) (transfer full): a #GMount for the mount of @file,
|
|
* or %NULL if @file has no mount
|
|
*/
|
|
GMount *
|
|
nautilus_file_info_get_mount (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_mount != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_mount (file);
|
|
}
|
|
|
|
char *
|
|
nautilus_file_info_get_uri_scheme (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_uri_scheme != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_uri_scheme (file);
|
|
}
|
|
|
|
char *
|
|
nautilus_file_info_get_mime_type (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_mime_type != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_mime_type (file);
|
|
}
|
|
|
|
gboolean
|
|
nautilus_file_info_is_mime_type (NautilusFileInfo *file,
|
|
const char *mime_type)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), FALSE);
|
|
g_return_val_if_fail (mime_type != NULL, FALSE);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->is_mime_type != NULL, FALSE);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->is_mime_type (file,
|
|
mime_type);
|
|
}
|
|
|
|
gboolean
|
|
nautilus_file_info_is_directory (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), FALSE);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->is_directory != NULL, FALSE);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->is_directory (file);
|
|
}
|
|
|
|
gboolean
|
|
nautilus_file_info_can_write (NautilusFileInfo *file)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), FALSE);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->can_write != NULL, FALSE);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->can_write (file);
|
|
}
|
|
|
|
void
|
|
nautilus_file_info_add_emblem (NautilusFileInfo *file,
|
|
const char *emblem_name)
|
|
{
|
|
g_return_if_fail (NAUTILUS_IS_FILE_INFO (file));
|
|
g_return_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->add_emblem != NULL);
|
|
|
|
NAUTILUS_FILE_INFO_GET_IFACE (file)->add_emblem (file, emblem_name);
|
|
}
|
|
|
|
char *
|
|
nautilus_file_info_get_string_attribute (NautilusFileInfo *file,
|
|
const char *attribute_name)
|
|
{
|
|
g_return_val_if_fail (NAUTILUS_IS_FILE_INFO (file), NULL);
|
|
g_return_val_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->get_string_attribute != NULL, NULL);
|
|
g_return_val_if_fail (attribute_name != NULL, NULL);
|
|
|
|
return NAUTILUS_FILE_INFO_GET_IFACE (file)->get_string_attribute
|
|
(file, attribute_name);
|
|
}
|
|
|
|
void
|
|
nautilus_file_info_add_string_attribute (NautilusFileInfo *file,
|
|
const char *attribute_name,
|
|
const char *value)
|
|
{
|
|
g_return_if_fail (NAUTILUS_IS_FILE_INFO (file));
|
|
g_return_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->add_string_attribute != NULL);
|
|
g_return_if_fail (attribute_name != NULL);
|
|
g_return_if_fail (value != NULL);
|
|
|
|
NAUTILUS_FILE_INFO_GET_IFACE (file)->add_string_attribute
|
|
(file, attribute_name, value);
|
|
}
|
|
|
|
void
|
|
nautilus_file_info_invalidate_extension_info (NautilusFileInfo *file)
|
|
{
|
|
g_return_if_fail (NAUTILUS_IS_FILE_INFO (file));
|
|
g_return_if_fail (NAUTILUS_FILE_INFO_GET_IFACE (file)->invalidate_extension_info != NULL);
|
|
|
|
NAUTILUS_FILE_INFO_GET_IFACE (file)->invalidate_extension_info (file);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_lookup:
|
|
* @location: the location to lookup the file info for
|
|
*
|
|
* Returns: (transfer full): a #NautilusFileInfo
|
|
*/
|
|
NautilusFileInfo *
|
|
nautilus_file_info_lookup (GFile *location)
|
|
{
|
|
return nautilus_file_info_getter (location, FALSE);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_create:
|
|
* @location: the location to create the file info for
|
|
*
|
|
* Returns: (transfer full): a #NautilusFileInfo
|
|
*/
|
|
NautilusFileInfo *
|
|
nautilus_file_info_create (GFile *location)
|
|
{
|
|
return nautilus_file_info_getter (location, TRUE);
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_lookup_for_uri:
|
|
* @uri: the URI to lookup the file info for
|
|
*
|
|
* Returns: (transfer full): a #NautilusFileInfo
|
|
*/
|
|
NautilusFileInfo *
|
|
nautilus_file_info_lookup_for_uri (const char *uri)
|
|
{
|
|
GFile *location;
|
|
NautilusFile *file;
|
|
|
|
location = g_file_new_for_uri (uri);
|
|
file = nautilus_file_info_lookup (location);
|
|
g_object_unref (location);
|
|
|
|
return file;
|
|
}
|
|
|
|
/**
|
|
* nautilus_file_info_create_for_uri:
|
|
* @uri: the URI to lookup the file info for
|
|
*
|
|
* Returns: (transfer full): a #NautilusFileInfo
|
|
*/
|
|
NautilusFileInfo *
|
|
nautilus_file_info_create_for_uri (const char *uri)
|
|
{
|
|
GFile *location;
|
|
NautilusFile *file;
|
|
|
|
location = g_file_new_for_uri (uri);
|
|
file = nautilus_file_info_create (location);
|
|
g_object_unref (location);
|
|
|
|
return file;
|
|
}
|