Commit e2285f08 authored by Matthias Clasen's avatar Matthias Clasen Committed by Matthias Clasen

Move docs inline, and improve wording. (#372598, Behdad Esfahbod)

2006-12-17  Matthias Clasen  <mclasen@redhat.com>

        * glib/gstrfuncs.c (g_strndup, g_strnfill): Move docs
        inline, and improve wording.  (#372598, Behdad Esfahbod)
parent ff290367
2006-12-17 Matthias Clasen <mclasen@redhat.com>
* glib/gstrfuncs.c (g_strndup, g_strnfill): Move docs
inline, and improve wording. (#372598, Behdad Esfahbod)
* glib/gspawn.c: Add some pointers to the gdk_spawn_
variants. (#338134, Federico Mena Quintero)
......
......@@ -53,17 +53,12 @@ The returned string should be freed when no longer needed.
<!-- ##### FUNCTION g_strndup ##### -->
<para>
Duplicates the first @n characters of a string, returning a newly-allocated
buffer @n + 1 characters long which will always be nul-terminated.
If @str is less than @n characters long the buffer is padded with nuls.
If @str is %NULL it returns %NULL.
The returned value should be freed when no longer needed.
</para>
@str: the string to duplicate part of.
@n: the maximum number of characters to copy from @str.
@Returns: a newly-allocated buffer containing the first @n characters of @str,
nul-terminated.
@str:
@n:
@Returns:
<!-- ##### FUNCTION g_strdupv ##### -->
......@@ -76,13 +71,12 @@ nul-terminated.
<!-- ##### FUNCTION g_strnfill ##### -->
<para>
Creates a new string @length characters long filled with @fill_char.
The returned string should be freed when no longer needed.
</para>
@length: the length of the new string.
@fill_char: the character to fill the string with.
@Returns: a newly-allocated string filled the @fill_char.
@length:
@fill_char:
@Returns:
<!-- ##### FUNCTION g_stpcpy ##### -->
......
......@@ -114,6 +114,25 @@ g_memdup (gconstpointer mem,
return new_mem;
}
/**
* g_strndup:
* @str: the string to duplicate
* @n: the maximum number of bytes to copy from @str
*
* Duplicates the first @n bytes of a string, returning a newly-allocated
* buffer @n + 1 bytes long which will always be nul-terminated.
* If @str is less than @n bytes long the buffer is padded with nuls.
* If @str is %NULL it returns %NULL.
* The returned value should be freed when no longer needed.
*
* <note><para>
* To copy a number of characters from a UTF-8 encoded string, use
* g_utf8_strncpy() instead.
* </para></note>
*
* Returns: a newly-allocated buffer containing the first @n bytes
* of @str, nul-terminated
*/
gchar*
g_strndup (const gchar *str,
gsize n)
......@@ -132,6 +151,16 @@ g_strndup (const gchar *str,
return new_str;
}
/**
* g_strnfill:
* @length: the length of the new string
* @fill_char: the byte to fill the string with
*
* Creates a new string @length bytes long filled with @fill_char.
* The returned string should be freed when no longer needed.
*
* Returns: a newly-allocated string filled the @fill_char
*/
gchar*
g_strnfill (gsize length,
gchar fill_char)
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment