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

Improve docs

Browse Source 
svn path=/trunk/; revision=7896
This commit is contained in:
Matthias Clasen 2009-02-23 04:23:14 +00:00
parent 45fdc135b2
commit 8ad668c7f0
2 changed files with 18 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
ChangeLog
View File

@ -1,3 +1,10 @@
2009-02-22 Matthias Clasen <mclasen@redhat.com>
Bug 572464 – Doc for g_file_get_contents
* glib/gfileutils.c (g_file_get_contents): Improve docs. Pointed
out by Øystein Johansen.
2009-02-22 Matthias Clasen <mclasen@redhat.com> 2009-02-22 Matthias Clasen <mclasen@redhat.com>
Bug 572672 – glib/gthread.c: argument is different type Bug 572672 – glib/gthread.c: argument is different type

21
glib/gfileutils.c
View File

@ -798,19 +798,20 @@ get_contents_win32 (const gchar *filename,
/** /**
* g_file_get_contents: * g_file_get_contents:
* @filename: name of a file to read contents from, in the GLib file name encoding * @filename: name of a file to read contents from, in the GLib file name encoding
* @contents: location to store an allocated string * @contents: location to store an allocated string, use g_free() to free
* the returned string
* @length: location to store length in bytes of the contents, or %NULL * @length: location to store length in bytes of the contents, or %NULL
* @error: return location for a #GError, or %NULL * @error: return location for a #GError, or %NULL
*
* Reads an entire file into allocated memory, with good error
* checking.
* *
* If the call was successful, it returns %TRUE and sets @contents to the file * Reads an entire file into allocated memory, with good error
* contents and @length to the length of the file contents in bytes. The string * checking.
* stored in @contents will be nul-terminated, so for text files you can pass *
* %NULL for the @length argument. If the call was not successful, it returns * If the call was successful, it returns %TRUE and sets @contents to the file
* %FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error * contents and @length to the length of the file contents in bytes. The string
* codes are those in the #GFileError enumeration. In the error case, * stored in @contents will be nul-terminated, so for text files you can pass
* %NULL for the @length argument. If the call was not successful, it returns
* %FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error
* codes are those in the #GFileError enumeration. In the error case,
* @contents is set to %NULL and @length is set to zero. * @contents is set to %NULL and @length is set to zero.
* *
* Return value: %TRUE on success, %FALSE if an error occurred * Return value: %TRUE on success, %FALSE if an error occurred