camel-string-utils

camel-string-utils —

Synopsis

gint                camel_strcase_equal                 (gconstpointer a,
                                                         gconstpointer b);
guint               camel_strcase_hash                  (gconstpointer v);
void                camel_string_list_free              (GList *string_list);
gchar *             camel_strstrcase                    (const gchar *haystack,
                                                         const gchar *needle);
const gchar *       camel_strdown                       (gchar *str);
gchar               camel_tolower                       (gchar c);
gchar               camel_toupper                       (gchar c);
const gchar *       camel_pstring_add                   (gchar *str,
                                                         gboolean own);
const gchar *       camel_pstring_strdup                (const gchar *s);
void                camel_pstring_free                  (const gchar *s);
const gchar *       camel_pstring_peek                  (const gchar *str);

Description

Details

camel_strcase_equal ()

gint                camel_strcase_equal                 (gconstpointer a,
                                                         gconstpointer b);

a :
b :
Returns :

camel_strcase_hash ()

guint               camel_strcase_hash                  (gconstpointer v);

v :
Returns :

camel_string_list_free ()

void                camel_string_list_free              (GList *string_list);

string_list :

camel_strstrcase ()

gchar *             camel_strstrcase                    (const gchar *haystack,
                                                         const gchar *needle);

haystack :
needle :
Returns :

camel_strdown ()

const gchar *       camel_strdown                       (gchar *str);

str :
Returns :

camel_tolower ()

gchar               camel_tolower                       (gchar c);

ASCII to-lower function.

Returns :

camel_toupper ()

gchar               camel_toupper                       (gchar c);

ASCII to-upper function.

Returns :

camel_pstring_add ()

const gchar *       camel_pstring_add                   (gchar *str,
                                                         gboolean own);

Add the string to the pool.

The NULL and empty strings are special cased to constant values.

str : string to add to the string pool
own : whether the string pool will own the memory pointed to by str, if str is not yet in the pool
Returns : A pointer to an equivalent string of s. Use camel_pstring_free() when it is no longer needed.

camel_pstring_strdup ()

const gchar *       camel_pstring_strdup                (const gchar *s);

Create a new pooled string entry for the string s. A pooled string is a table where common strings are uniquified to the same pointer value. They are also refcounted, so freed when no longer in use. In a thread-safe manner.

The NULL and empty strings are special cased to constant values.

s : String to copy.
Returns : A pointer to an equivalent string of s. Use camel_pstring_free() when it is no longer needed.

camel_pstring_free ()

void                camel_pstring_free                  (const gchar *s);

De-ref a pooled string. If no more refs exist to this string, it will be deallocated.

NULL and the empty string are special cased.

s : String to free.

camel_pstring_peek ()

const gchar *       camel_pstring_peek                  (const gchar *str);

Add return the string from the pool.

The NULL and empty strings are special cased to constant values.

str : string to fetch to the string pool
Returns : A pointer to an equivalent string of s. Use camel_pstring_free() when it is no longer needed.

Since 2.24