1999-08-16 17:58:30 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
String Utility Functions
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strdup ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@str:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strndup ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@str:
|
|
|
|
@n:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strnfill ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@length:
|
|
|
|
@fill_char:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
<!-- ##### FUNCTION g_strlcpy ##### -->
|
1999-08-16 17:58:30 +00:00
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@dest:
|
|
|
|
@src:
|
|
|
|
@dest_size:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
<!-- ##### FUNCTION g_strlcat ##### -->
|
1999-08-16 17:58:30 +00:00
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@dest:
|
|
|
|
@src:
|
|
|
|
@dest_size:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
<!-- ##### FUNCTION g_strdup_printf ##### -->
|
1999-08-16 17:58:30 +00:00
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
|
|
|
@format:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strdup_vprintf ##### -->
|
1999-08-16 17:58:30 +00:00
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
|
|
|
@format:
|
|
|
|
@args:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_snprintf ##### -->
|
1999-08-16 17:58:30 +00:00
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@n:
|
|
|
|
@format:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_vsnprintf ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@n:
|
|
|
|
@format:
|
|
|
|
@args:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_printf_string_upper_bound ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@format:
|
|
|
|
@args:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strup ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strdown ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strcasecmp ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@s1:
|
|
|
|
@s2:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strncasecmp ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@s1:
|
|
|
|
@s2:
|
|
|
|
@n:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strreverse ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strtod ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@nptr:
|
|
|
|
@endptr:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strchug ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strchomp ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO g_strstrip ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strdelimit ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@delimiters:
|
|
|
|
@new_delimiter:
|
1999-08-16 17:58:30 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO G_STR_DELIMITERS ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strescape ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@exceptions:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strcompress ##### -->
|
|
|
|
<para>
|
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strcanon ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@string:
|
|
|
|
@valid_chars:
|
|
|
|
@subsitutor:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strsplit ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string:
|
|
|
|
@delimiter:
|
|
|
|
@max_tokens:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strfreev ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@str_array:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strconcat ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@string1:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strjoin ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@separator:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strjoinv ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@separator:
|
|
|
|
@str_array:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strerror ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@errnum:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION g_strsignal ##### -->
|
|
|
|
<para>
|
2000-09-06 00:04:49 +00:00
|
|
|
|
1999-08-16 17:58:30 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-06 00:04:49 +00:00
|
|
|
@signum:
|
|
|
|
@Returns:
|
1999-08-16 17:58:30 +00:00
|
|
|
|
|
|
|
|