luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 23:16:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'docs' into 'master'

Browse Source 
docs: Add (nullable) annotations

Closes #2124

See merge request GNOME/glib!1521
This commit is contained in:
Philip Withnall 2020-06-05 14:05:12 +00:00
commit 633413909d
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
gio/gfileinfo.c
View File

@ -858,8 +858,8 @@ g_file_info_get_attribute_as_string (GFileInfo *info,
* Gets the value of a #GObject attribute. If the attribute does
* not contain a #GObject, %NULL will be returned.
*
* Returns: (transfer none): a #GObject associated with the given @attribute, or
* %NULL otherwise.
* Returns: (transfer none) (nullable): a #GObject associated with the given @attribute,
* or %NULL otherwise.
**/
GObject *
g_file_info_get_attribute_object (GFileInfo *info,
@ -882,8 +882,8 @@ g_file_info_get_attribute_object (GFileInfo *info,
* Gets the value of a string attribute. If the attribute does
* not contain a string, %NULL will be returned.
*
* Returns: the contents of the @attribute value as a UTF-8 string, or
* %NULL otherwise.
* Returns: (nullable): the contents of the @attribute value as a UTF-8 string,
* or %NULL otherwise.
**/
const char *
g_file_info_get_attribute_string (GFileInfo *info,
@ -906,7 +906,7 @@ g_file_info_get_attribute_string (GFileInfo *info,
* Gets the value of a byte string attribute. If the attribute does
* not contain a byte string, %NULL will be returned.
*
* Returns: the contents of the @attribute value as a byte string, or
* Returns: (nullable): the contents of the @attribute value as a byte string, or
* %NULL otherwise.
**/
const char *
@ -930,8 +930,8 @@ g_file_info_get_attribute_byte_string (GFileInfo *info,
* Gets the value of a stringv attribute. If the attribute does
* not contain a stringv, %NULL will be returned.
*
* Returns: (transfer none): the contents of the @attribute value as a stringv, or
* %NULL otherwise. Do not free. These returned strings are UTF-8.
* Returns: (transfer none) (nullable): the contents of the @attribute value as a stringv,
* or %NULL otherwise. Do not free. These returned strings are UTF-8.
*
* Since: 2.22
**/
@ -1454,7 +1454,7 @@ g_file_info_set_attribute_int64 (GFileInfo *info,
* available in G_FILE_ATTRIBUTE_TRASH_DELETION_DATE. If the
* G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned.
*
* Returns: a #GDateTime, or %NULL.
* Returns: (nullable): a #GDateTime, or %NULL.
*
* Since: 2.36
**/
@ -1708,7 +1708,8 @@ g_file_info_get_symbolic_icon (GFileInfo *info)
*
* Gets the file's content type.
*
* Returns: a string containing the file's content type.
* Returns: (nullable): a string containing the file's content type,
* or %NULL if unknown.
**/
const char *
g_file_info_get_content_type (GFileInfo *info)
@ -2728,7 +2729,7 @@ g_file_attribute_matcher_enumerate_namespace (GFileAttributeMatcher *matcher,
*
* Gets the next matched attribute from a #GFileAttributeMatcher.
*
* Returns: a string containing the next attribute or %NULL if
* Returns: (nullable): a string containing the next attribute or, %NULL if
* no more attribute exist.
**/
const char *