Minor doc clarification

Spell out that g_utf8_strlen() behaves like strlen() wrt. to
termination. Bug 612040.
This commit is contained in:
Matthias Clasen 2010-03-08 00:04:11 -05:00
parent 485077e9ce
commit 42f042d5fb

View File

@ -215,13 +215,14 @@ g_utf8_prev_char (const gchar *p)
/**
* g_utf8_strlen:
* @p: pointer to the start of a UTF-8 encoded string.
* @p: pointer to the start of a UTF-8 encoded string
* @max: the maximum number of bytes to examine. If @max
* is less than 0, then the string is assumed to be
* nul-terminated. If @max is 0, @p will not be examined and
* nul-terminated. If @max is 0, @p will not be examined and
* may be %NULL.
*
* Returns the length of the string in characters.
*
* Computes the length of the string in characters, not including
* the terminating nul character.
*
* Return value: the length of the string in characters
**/
@ -245,13 +246,13 @@ g_utf8_strlen (const gchar *p,
{
if (max == 0 || !*p)
return 0;
p = g_utf8_next_char (p);
p = g_utf8_next_char (p);
while (p - start < max && *p)
{
++len;
p = g_utf8_next_char (p);
p = g_utf8_next_char (p);
}
/* only do the last len increment if we got a complete