diff options
author | António Fernandes <antoniof@gnome.org> | 2021-07-26 19:09:04 +0100 |
---|---|---|
committer | António Fernandes <antoniof@gnome.org> | 2021-07-26 23:50:41 +0100 |
commit | 4ffe95e64caddd4d11934d4f0d96b62fae075a9f (patch) | |
tree | 5509a138f71e238dd1359b22a130e0266c2ad152 | |
parent | 2f9b0e6635846fe6c93f269d4215c47eec4216cf (diff) | |
download | nautilus-4ffe95e64caddd4d11934d4f0d96b62fae075a9f.tar.gz |
file: Document ::{get,set}_metadata_list()wip/antoniof/metadata-lists-optimization
As they have been touched in the last two commits, and to clarify they
don't actually mean a GList but rather a GStrv.
-rw-r--r-- | src/nautilus-file.c | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/src/nautilus-file.c b/src/nautilus-file.c index f0d32caf3..e602740d3 100644 --- a/src/nautilus-file.c +++ b/src/nautilus-file.c @@ -4138,6 +4138,15 @@ nautilus_file_get_metadata (NautilusFile *file, return g_strdup (default_metadata); } +/** + * nautilus_file_get_metadata_list: + * @file: A #NautilusFile to get metadata from. + * @key: A string representation of the metadata key (use macros when possible). + * + * Get the value of a metadata attribute which holds a list of strings. + * + * Returns: (transfer full): A zero-terminated array of newly allocated strings. + */ gchar ** nautilus_file_get_metadata_list (NautilusFile *file, const char *key) @@ -4185,6 +4194,14 @@ nautilus_file_set_metadata (NautilusFile *file, NAUTILUS_FILE_CLASS (G_OBJECT_GET_CLASS (file))->set_metadata (file, key, val); } +/** + * nautilus_file_set_metadata_list: + * @file: A #NautilusFile to set metadata into. + * @key: A string representation of the metadata key (use macros when possible). + * @list: (transfer none): A zero-terminated array of newly allocated strings. + * + * Set the value of a metadata attribute which takes a list of strings. + */ void nautilus_file_set_metadata_list (NautilusFile *file, const char *key, |