| GOffice Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
GOString; GOStringPhonetic; GOString * go_string_ERROR (void); int go_string_cmp (gconstpointer gstr_a,gconstpointer gstr_b); int go_string_cmp_ignorecase (gconstpointer gstr_a,gconstpointer gstr_b); gboolean go_string_equal (gconstpointer gstr_a,gconstpointer gstr_b); gboolean go_string_equal_ignorecase (gconstpointer gstr_a,gconstpointer gstr_b); gboolean go_string_equal_rich (gconstpointer gstr_a,gconstpointer gstr_b); void go_string_foreach_base (GHFunc callback,gpointer data); char const * go_string_get_casefold (GOString const *gstr); char const * go_string_get_casefolded_collate (GOString const *gstr); char const * go_string_get_collation (GOString const *gstr); guint32 go_string_get_len (GOString const *gstr); PangoAttrList * go_string_get_markup (GOString const *gstr); GOStringPhonetic * go_string_get_phonetic (GOString const *gstr); unsigned int go_string_get_ref_count (GOString const *gstr); guint32 go_string_hash (gconstpointer gstr); GOString * go_string_new (char const *str); GOString * go_string_new_len (char const *str,guint32 len); GOString * go_string_new_nocopy (char *str); GOString * go_string_new_nocopy_len (char *str,guint32 len); GOString * go_string_new_rich (char const *str,int byte_len,PangoAttrList *markup,GOStringPhonetic *phonetic); GOString * go_string_new_rich_nocopy (char *str,int byte_len,PangoAttrList *markup,GOStringPhonetic *phonetic); GOString * go_string_ref (GOString *gstr); GOString * go_string_trim (GOString *gstr,gboolean internal); void go_string_unref (GOString *gstr);
typedef struct {
char const *str; /* utf-8 */
/* <private data> */
} GOString;
GOString is a structure containing a string.
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. |
int go_string_cmp_ignorecase (gconstpointer gstr_a,gconstpointer gstr_b);
gboolean go_string_equal_ignorecase (gconstpointer gstr_a,gconstpointer gstr_b);
|
string. |
|
string. |
Returns : |
TRUE if the two strings are equal when ignoring letter case. |
gboolean go_string_equal_rich (gconstpointer gstr_a,gconstpointer gstr_b);
|
string. |
|
string. |
void go_string_foreach_base (GHFunc callback,gpointer data);
Iterates through the strings data base and apply callback to each.
|
callback. [scope call] |
|
user data |
char const * go_string_get_casefolded_collate (GOString const *gstr);
GOStringPhonetic * go_string_get_phonetic (GOString const *gstr);
Warning: Not implemented, always returns NULL.
|
GOString. |
Returns : |
the phonetic data. [transfer none] |
GOString * go_string_new (char const *str);
GOString duplicates str if no string already exists.
|
string (optionally NULL) |
Returns : |
a reference to a GOString containing str, or NULL if str is NULL |
GOString * go_string_new_len (char const *str,guint32 len);
GOString duplicates str if no string already exists.
|
string (optionally NULL) |
|
guint32 |
Returns : |
a reference to a GOString containing str, or NULL if str is NULL |
GOString * go_string_new_nocopy (char *str);
GOString takes ownership of str
|
string |
Returns : |
a reference to a GOString containing str
|
GOString * go_string_new_nocopy_len (char *str,guint32 len);
GOString takes ownership of str
|
string (optionally NULL) |
|
guint32 |
Returns : |
a reference to a GOString containing str
|
GOString * go_string_new_rich (char const *str,int byte_len,PangoAttrList *markup,GOStringPhonetic *phonetic);
|
string. |
|
< 0 will call strlen. |
|
optionally NULL list, GOString steals the ref. |
|
optionally NULL list of phonetic extensions, GOString steals the ref. |
Returns : |
a string. |
GOString * go_string_new_rich_nocopy (char *str,int byte_len,PangoAttrList *markup,GOStringPhonetic *phonetic);
|
string; GOString takes ownership |
|
< 0 will call strlen. |
|
optionally NULL list, GOString steals the ref. |
|
optionally NULL list of phonetic extensions, GOString steals the ref. |
Returns : |
a string. |
GOString * go_string_trim (GOString *gstr,gboolean internal);
|
string. |
|
Trim multiple consequtive internal spaces. |
Returns : |
gstr |