String Utility Functions

String Utility Functions — various string-related functions.
Synopsis


#include <glib.h>
#include <glib/gprintf.h>


gchar*      g_strdup                        (const gchar *str);
gchar*      g_strndup                       (const gchar *str,
                                             gsize n);
gchar**     g_strdupv                       (gchar **str_array);
gchar*      g_strnfill                      (gsize length,
                                             gchar fill_char);
gchar*      g_stpcpy                        (gchar *dest,
                                             const char *src);
gchar*      g_strstr_len                    (const gchar *haystack,
                                             gssize haystack_len,
                                             const gchar *needle);
gchar*      g_strrstr                       (const gchar *haystack,
                                             const gchar *needle);
gchar*      g_strrstr_len                   (const gchar *haystack,
                                             gssize haystack_len,
                                             const gchar *needle);
gboolean    g_str_has_prefix                (const gchar *str,
                                             const gchar *prefix);
gboolean    g_str_has_suffix                (const gchar *str,
                                             const gchar *suffix);

gsize       g_strlcpy                       (gchar *dest,
                                             const gchar *src,
                                             gsize dest_size);
gsize       g_strlcat                       (gchar *dest,
                                             const gchar *src,
                                             gsize dest_size);

gchar*      g_strdup_printf                 (const gchar *format,
                                             ...);
gchar*      g_strdup_vprintf                (const gchar *format,
                                             va_list args);
gint        g_printf                        (gchar const *format,
                                             ...);
gint        g_vprintf                       (gchar const *format,
                                             va_list args);
gint        g_fprintf                       (FILE *file,
                                             gchar const *format,
                                             ...);
gint        g_vfprintf                      (FILE *file,
                                             gchar const *format,
                                             va_list args);
gint        g_sprintf                       (gchar *string,
                                             gchar const *format,
                                             ...);
gint        g_vsprintf                      (gchar *string,
                                             gchar const *format,
                                             va_list args);
gint        g_snprintf                      (gchar *string,
                                             gulong n,
                                             gchar const *format,
                                             ...);
gint        g_vsnprintf                     (gchar *string,
                                             gulong n,
                                             gchar const *format,
                                             va_list args);
gint        g_vasprintf                     (gchar **string,
                                             gchar const *format,
                                             va_list args);
gsize       g_printf_string_upper_bound     (const gchar *format,
                                             va_list args);

gboolean    g_ascii_isalnum                 (gchar c);
gboolean    g_ascii_isalpha                 (gchar c);
gboolean    g_ascii_iscntrl                 (gchar c);
gboolean    g_ascii_isdigit                 (gchar c);
gboolean    g_ascii_isgraph                 (gchar c);
gboolean    g_ascii_islower                 (gchar c);
gboolean    g_ascii_isprint                 (gchar c);
gboolean    g_ascii_ispunct                 (gchar c);
gboolean    g_ascii_isspace                 (gchar c);
gboolean    g_ascii_isupper                 (gchar c);
gboolean    g_ascii_isxdigit                (gchar c);

gint        g_ascii_digit_value             (gchar c);
gint        g_ascii_xdigit_value            (gchar c);

gint        g_ascii_strcasecmp              (const gchar *s1,
                                             const gchar *s2);
gint        g_ascii_strncasecmp             (const gchar *s1,
                                             const gchar *s2,
                                             gsize n);

gchar*      g_ascii_strup                   (const gchar *str,
                                             gssize len);
gchar*      g_ascii_strdown                 (const gchar *str,
                                             gssize len);

gchar       g_ascii_tolower                 (gchar c);
gchar       g_ascii_toupper                 (gchar c);

GString*    g_string_ascii_up               (GString *string);
GString*    g_string_ascii_down             (GString *string);

gchar*      g_strup                         (gchar *string);
gchar*      g_strdown                       (gchar *string);

gint        g_strcasecmp                    (const gchar *s1,
                                             const gchar *s2);
gint        g_strncasecmp                   (const gchar *s1,
                                             const gchar *s2,
                                             guint n);

gchar*      g_strreverse                    (gchar *string);

guint64     g_ascii_strtoull                (const gchar *nptr,
                                             gchar **endptr,
                                             guint base);
#define     G_ASCII_DTOSTR_BUF_SIZE
gdouble     g_ascii_strtod                  (const gchar *nptr,
                                             gchar **endptr);
gchar*      g_ascii_dtostr                  (gchar *buffer,
                                             gint buf_len,
                                             gdouble d);
gchar*      g_ascii_formatd                 (gchar *buffer,
                                             gint buf_len,
                                             const gchar *format,
                                             gdouble d);
gdouble     g_strtod                        (const gchar *nptr,
                                             gchar **endptr);

gchar*      g_strchug                       (gchar *string);
gchar*      g_strchomp                      (gchar *string);
#define     g_strstrip                      ( string )

gchar*      g_strdelimit                    (gchar *string,
                                             const gchar *delimiters,
                                             gchar new_delimiter);
#define     G_STR_DELIMITERS
gchar*      g_strescape                     (const gchar *source,
                                             const gchar *exceptions);
gchar*      g_strcompress                   (const gchar *source);
gchar*      g_strcanon                      (gchar *string,
                                             const gchar *valid_chars,
                                             gchar substitutor);
gchar**     g_strsplit                      (const gchar *string,
                                             const gchar *delimiter,
                                             gint max_tokens);
gchar**     g_strsplit_set                  (const gchar *string,
                                             const gchar *delimiters,
                                             gint max_tokens);
void        g_strfreev                      (gchar **str_array);
gchar*      g_strconcat                     (const gchar *string1,
                                             ...);
gchar*      g_strjoin                       (const gchar *separator,
                                             ...);
gchar*      g_strjoinv                      (const gchar *separator,
                                             gchar **str_array);
guint       g_strv_length                   (gchar **str_array);

const gchar* g_strerror                     (gint errnum);
const gchar* g_strsignal                    (gint signum);
Description

This section describes a number of utility functions for creating, duplicating, and manipulating strings.
			GLib Reference Manual
Top \| Description