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);


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);


go_string_unref ()

void
go_string_unref (GOString *gstr);


go_string_get_len ()

guint32
go_string_get_len (GOString const *gstr);

go_string_get_ref_count ()

unsigned int
go_string_get_ref_count (GOString const *gstr);


go_string_get_collation ()

char const	 *
go_string_get_collation (GOString const *gstr);


go_string_get_casefold ()

char const	 *
go_string_get_casefold (GOString const *gstr);


go_string_get_markup ()

PangoAttrList *
go_string_get_markup (GOString const *gstr);

go_string_get_phonetic ()

GOStringPhonetic *
go_string_get_phonetic (GOString const *gstr);

go_string_hash ()

guint32
go_string_hash (gconstpointer gstr);


go_string_cmp ()

int
go_string_cmp (gconstpointer gstr_a,
               gconstpointer gstr_b);


go_string_cmp_ignorecase ()

int
go_string_cmp_ignorecase (gconstpointer gstr_a,
                          gconstpointer gstr_b);


go_string_equal ()

gboolean
go_string_equal (gconstpointer gstr_a,
                 gconstpointer gstr_b);


go_string_equal_ignorecase ()

gboolean
go_string_equal_ignorecase (gconstpointer gstr_a,
                            gconstpointer gstr_b);

go_string_equal_rich ()

gboolean
go_string_equal_rich (gconstpointer gstr_a,
                      gconstpointer gstr_b);


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;