Add note about g_utf8_offset_to_pointer() not checking string

boundaries.

* glib/gutf8.c (g_utf8_offset_to_pointer()): See summary.

svn path=/trunk/; revision=7861
This commit is contained in:
Mathias Hasselmann 2009-02-13 14:20:17 +00:00
parent 82e1d3e753
commit cf01757ba0
2 changed files with 21 additions and 5 deletions

View File

@ -1,3 +1,10 @@
2009-02-13 Mathias Hasselmann <hasselmm@gnome.org>
Add note about g_utf8_offset_to_pointer() not checking string
boundaries.
* glib/gutf8.c (g_utf8_offset_to_pointer()): See summary.
2999-02-11 Matthias Clasen <mclasen@redhat.com>
Bug 523742 Use noinst for non-installable libraries

View File

@ -288,6 +288,15 @@ g_utf8_get_char (const gchar *p)
* instead of forwards if @offset is in the last fourth of the string,
* since moving forward is about 3 times faster than moving backward.
*
* <note><para>
* This function doesn't abort when reaching the end of @str. Therefore
* you should be sure that @offset is within string boundaries before
* calling that function. Call g_utf8_strlen() when unsure.
*
* This limitation exists as this function is called frequently during
* text rendering and therefore has to be as fast as possible.
* </para></note>
*
* Return value: the resulting pointer
**/
gchar *