luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-26 01:20:05 +01:00
Code Issues Packages Projects Releases Wiki Activity

Mention g_utf8_normalize() returns NULL on invalid string. (#501997)

Browse Source 
* glib/gunidecomp.c: Mention g_utf8_normalize()
returns NULL on invalid string. (#501997)

svn path=/trunk/; revision=6058
This commit is contained in:
Mathias Hasselmann 2007-12-06 10:22:13 +00:00
parent 6356a9dd98
commit c79ef3793c
2 changed files with 14 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
2007-12-06 Mathias Hasselmann <mathias@openismus.com>
* glib/gunidecomp.c: Mention g_utf8_normalize()
returns NULL on invalid string. (#501997)
2007-12-06 Mathias Hasselmann <mathias@openismus.com>
* glib/gerror.c: Improve wording for g_propagate_error docs.

16
glib/gunidecomp.c
View File

@ -486,13 +486,14 @@ _g_utf8_normalize_wc (const gchar *str,
* @str: a UTF-8 encoded string.
* @len: length of @str, in bytes, or -1 if @str is nul-terminated.
* @mode: the type of normalization to perform.
*
*
* Converts a string into canonical form, standardizing
* such issues as whether a character with an accent
* is represented as a base character and combining
* accent or as a single precomposed character. You
* should generally call g_utf8_normalize() before
* comparing two Unicode strings.
* accent or as a single precomposed character. The
* string has to be valid UTF-8, otherwise %NULL is
* returned. You should generally call g_utf8_normalize()
* before comparing two Unicode strings.
*
* The normalization mode %G_NORMALIZE_DEFAULT only
* standardizes differences that do not affect the
@ -513,9 +514,10 @@ _g_utf8_normalize_wc (const gchar *str,
* useful if you intend to convert the string to
* a legacy encoding or pass it to a system with
* less capable Unicode handling.
*
* Return value: a newly allocated string, that is the
* normalized form of @str.
*
* Return value: a newly allocated string, that is the
* normalized form of @str, or %NULL if @str is not
* valid UTF-8.
**/
gchar *
g_utf8_normalize (const gchar *str,