camel-string-utils: Camel Reference Manual

## camel-string-utils camel-string-utils |

## Functions

gint | camel_strcase_equal ()
guint | camel_strcase_hash ()
gchar * | camel_strstrcase ()
const gchar * | camel_strdown ()
const gchar * | camel_pstring_add ()
const gchar * | camel_pstring_strdup ()
void | camel_pstring_free ()
const gchar * | camel_pstring_peek ()
void | camel_pstring_dump_stat ()

## Description

## Functions

### camel_strcase_equal ()

    gint
    camel_strcase_equal (gconstpointer a,
                         gconstpointer b);

### camel_strcase_hash ()

    guint
    camel_strcase_hash (gconstpointer v);

### camel_strstrcase ()

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

### camel_strdown ()

    const gchar *
    camel_strdown (gchar *str);

### camel_pstring_add ()

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

Add `string` to the pool.

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

Unreference the returned string with `camel_pstring_free()`.

#### Parameters

string | string to add to the string pool |
own | whether the string pool will own the memory pointed to by `string` , if `string` is not yet in the pool |

#### Returns

a canonicalized copy of `string`

### camel_pstring_strdup ()

    const gchar *
    camel_pstring_strdup (const gchar *string);

Create a new pooled string entry for `strings` . A pooled string is a table where common strings are canonicalized. They are also reference counted and freed when no longer referenced.

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

Unreference the returned string with `camel_pstring_free()`.

#### Parameters

string | string to copy |

#### Returns

a canonicalized copy of `string`

### camel_pstring_free ()

    void
    camel_pstring_free (const gchar *string);

Unreferences a pooled string. If the string's reference count drops to zero it will be deallocated. `NULL` and the empty string are special cased.

#### Parameters

string | string to free |

### camel_pstring_peek ()

    const gchar *
    camel_pstring_peek (const gchar *string);

Returns the canonicalized copy of `string` without increasing its reference count in the string pool. If necessary, `string` is first added to the string pool.

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

#### Parameters

string | string to fetch from the string pool |

#### Returns

a canonicalized copy of `string`

Since: 2.24

### camel_pstring_dump_stat ()

    void
    camel_pstring_dump_stat (void);

Dumps to stdout memory statistic about the string pool.

Since: 3.6

## Types and Values