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

Clarify docs for g_uri_unescape_string() (#508773)

Browse Source 
2008-01-15  Alexander Larsson  <alexl@redhat.com>

        * glib/gurifuncs.c:
	Clarify docs for g_uri_unescape_string() (#508773)



svn path=/trunk/; revision=6317
This commit is contained in:
Alexander Larsson 2008-01-15 13:09:07 +00:00 committed by Alexander Larsson
parent a1996e6518
commit 9d0f6b8f94
2 changed files with 20 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
2008-01-15 Alexander Larsson <alexl@redhat.com>
* glib/gurifuncs.c:
Clarify docs for g_uri_unescape_string() (#508773)
2008-01-14 Dan Winship <danw@gnome.org> 2008-01-14 Dan Winship <danw@gnome.org>
* m4macros/glib-2.0.m4: Support gio in AM_PATH_GLIB_2_0 (#509465) * m4macros/glib-2.0.m4: Support gio in AM_PATH_GLIB_2_0 (#509465)

18
glib/gurifuncs.c
View File

@ -57,10 +57,16 @@ unescape_character (const char *scanner)
* g_uri_unescape_segment: * g_uri_unescape_segment:
* @escaped_string: a string. * @escaped_string: a string.
* @escaped_string_end: a string. * @escaped_string_end: a string.
* @illegal_characters: a string of illegal characters not to be allowed. * @illegal_characters: an optional string of illegal characters not to be allowed.
* *
* Unescapes a segment of an escaped string. * Unescapes a segment of an escaped string.
* *
* If any of the characters in @illegal_characters or the character zero appears
* as an escaped character in @escaped_string then that is an error and %NULL
* will be returned. This is useful it you want to avoid for instance having a
* slash being expanded in an escaped path element, which might confuse pathname
* handling.
*
* Returns: an unescaped version of @escaped_string or %NULL on error. * Returns: an unescaped version of @escaped_string or %NULL on error.
* The returned string should be freed when no longer needed. * The returned string should be freed when no longer needed.
* *
@ -123,10 +129,16 @@ g_uri_unescape_segment (const char *escaped_string,
/** /**
* g_uri_unescape_string: * g_uri_unescape_string:
* @escaped_string: an escaped string to be unescaped. * @escaped_string: an escaped string to be unescaped.
* @illegal_characters: a string of illegal characters not to be allowed. * @illegal_characters: an optional string of illegal characters not to be allowed.
* *
* Unescapes a whole escaped string. * Unescapes a whole escaped string.
* *
* If any of the characters in @illegal_characters or the character zero appears
* as an escaped character in @escaped_string then that is an error and %NULL
* will be returned. This is useful it you want to avoid for instance having a
* slash being expanded in an escaped path element, which might confuse pathname
* handling.
*
* Returns: an unescaped version of @escaped_string. The returned string * Returns: an unescaped version of @escaped_string. The returned string
* should be freed when no longer needed. * should be freed when no longer needed.
* *