luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-11-04 10:08:56 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'file-info-docs' into 'main'

Browse Source 
gfileinfo: Slightly expand docs for g_file_info_get_attribute_as_string()

See merge request GNOME/glib!4557
This commit is contained in:
Philip Withnall
2025-03-19 20:05:06 +00:00
parent 7ea8543f7e 787f47f091
commit b0568c845d
1 changed files with 18 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
gio/gfileinfo.c
View File

@@ -873,9 +873,24 @@ _g_file_info_get_attribute_value (GFileInfo *info,
* @info: a #GFileInfo.
* @attribute: a file attribute key.
*
* Gets the value of an attribute, formatted as a string.
* This escapes things as needed to make the string valid
* UTF-8.
* Gets the value of an attribute, formatted as a human readable string.
*
* This escapes things as needed to make the string valid UTF-8 and readable by
* humans. It’s not meant to be a machine readable or reversible escaping
* format.
*
* To format file name attributes of type
* [enum@Gio.FileAttributeType.BYTE_STRING] for output as UTF-8, use
* [func@GLib.filename_to_utf8] instead:
* ```c
* const char *trash_orig_path_byte_string;
* g_autofree char *trash_orig_path_utf8 = NULL;
*
* trash_orig_path_byte_string = g_file_info_get_attribute_byte_string (info, G_FILE_ATTRIBUTE_TRASH_ORIG_PATH);
* trash_orig_path_utf8 = g_filename_to_utf8 (trash_orig_path_byte_string, -1, NULL, NULL, NULL);
* if (trash_orig_path_utf8 != NULL)
* g_message ("Some larger UTF-8 string with filename embedded as %s", trash_orig_path_utf8);
* ```
*
* Returns: (nullable): a UTF-8 string associated with the given @attribute, or
* %NULL if the attribute wasn’t set.