go-string

go-string

Functions

Types and Values

Object Hierarchy

    GBoxed
    ╰── GOString

Description

Functions

go_string_get_type ()

GType
go_string_get_type (void);

Register GOString as a type for GValue

Returns

GType


go_string_new ()

GOString *
go_string_new (char const *str);

GOString duplicates str if no string already exists.

Parameters

str

string (optionally NULL)

 

Returns

a reference to a GOString containing str , or NULL if str is NULL


go_string_new_len ()

GOString *
go_string_new_len (char const *str,
                   guint32 len);

GOString duplicates str if no string already exists.

Parameters

str

string (optionally NULL)

 

len

guint32

 

Returns

a reference to a GOString containing str , or NULL if str is NULL


go_string_new_nocopy ()

GOString *
go_string_new_nocopy (char *str);

GOString takes ownership of str

Parameters

str

string

 

Returns

a reference to a GOString containing str


go_string_new_nocopy_len ()

GOString *
go_string_new_nocopy_len (char *str,
                          guint32 len);

Returns


go_string_new_rich ()

GOString *
go_string_new_rich (char const *str,
                    int byte_len,
                    gboolean copy,
                    PangoAttrList *markup,
                    GOStringPhonetic *phonetic);

Parameters

str

string.

 

byte_len

< 0 will call strlen.

 

copy

TRUE str should be copied when adding to the string table.

 

markup

optionally NULL list, GOString steals the ref.

 

phonetic

optionally NULL list of phonetic extensions, GOString steals the ref.

 

Returns

a string.


go_string_ref ()

GOString *
go_string_ref (GOString *gstr);

Returns


go_string_unref ()

void
go_string_unref (GOString *gstr);


go_string_get_len ()

guint32
go_string_get_len (GOString const *gstr);

Returns


go_string_get_ref_count ()

unsigned int
go_string_get_ref_count (GOString const *gstr);

Returns


go_string_get_collation ()

char const	 *
go_string_get_collation (GOString const *gstr);

Returns


go_string_get_casefold ()

char const	 *
go_string_get_casefold (GOString const *gstr);

Returns


go_string_get_markup ()

PangoAttrList *
go_string_get_markup (GOString const *gstr);

Returns


go_string_get_phonetic ()

GOStringPhonetic *
go_string_get_phonetic (GOString const *gstr);

Returns


go_string_hash ()

guint32
go_string_hash (gconstpointer gstr);

Returns


go_string_cmp ()

int
go_string_cmp (gconstpointer gstr_a,
               gconstpointer gstr_b);

Returns


go_string_cmp_ignorecase ()

int
go_string_cmp_ignorecase (gconstpointer gstr_a,
                          gconstpointer gstr_b);

Returns


go_string_equal ()

gboolean
go_string_equal (gconstpointer gstr_a,
                 gconstpointer gstr_b);

Returns


go_string_equal_ignorecase ()

gboolean
go_string_equal_ignorecase (gconstpointer gstr_a,
                            gconstpointer gstr_b);

Returns


go_string_equal_rich ()

gboolean
go_string_equal_rich (gconstpointer gstr_a,
                      gconstpointer gstr_b);

Returns


go_string_ERROR ()

GOString *
go_string_ERROR (void);

A convenience for g_return_val to share one error string without adding a reference to functions that do not add references to the result

Returns

A string saying 'ERROR' but does not add a ref to it.


go_string_foreach_base ()

void
go_string_foreach_base (GHFunc callback,
                        gpointer data);

Types and Values

GOStringPhonetic

typedef struct _GOStringPhonetic GOStringPhonetic;


GOString

typedef struct {
	char const *str; /* utf-8 */
	/* <private data> */
} GOString;