Go to the source code of this file.
Typedefs | |
typedef struct _PurpleStringref | PurpleStringref |
Functions | |
PurpleStringref * | purple_stringref_new (const char *value) |
Creates an immutable reference-counted string object. | |
PurpleStringref * | purple_stringref_new_noref (const char *value) |
Creates an immutable reference-counted string object. | |
PurpleStringref * | purple_stringref_printf (const char *format,...) |
Creates an immutable reference-counted string object from a printf format specification and arguments. | |
PurpleStringref * | purple_stringref_ref (PurpleStringref *stringref) |
Increase the reference count of the given stringref. | |
void | purple_stringref_unref (PurpleStringref *stringref) |
Decrease the reference count of the given stringref. | |
const char * | purple_stringref_value (const PurpleStringref *stringref) |
Retrieve the value of a stringref. | |
int | purple_stringref_cmp (const PurpleStringref *s1, const PurpleStringref *s2) |
Compare two stringrefs for string equality. | |
size_t | purple_stringref_len (const PurpleStringref *stringref) |
Find the length of the string inside a stringref. |
Definition in file stringref.h.
int purple_stringref_cmp | ( | const PurpleStringref * | s1, | |
const PurpleStringref * | s2 | |||
) |
Compare two stringrefs for string equality.
This returns the same value as strcmp would, where <0 indicates that s1 is "less than" s2 in the ASCII lexicography, 0 indicates equality, etc.
s1 | The reference string. | |
s2 | The string to compare against the reference. |
size_t purple_stringref_len | ( | const PurpleStringref * | stringref | ) |
Find the length of the string inside a stringref.
stringref | The string in whose length we are interested. |
PurpleStringref* purple_stringref_new | ( | const char * | value | ) |
Creates an immutable reference-counted string object.
The newly created object will have a reference count of 1.
value | This will be the value of the string; it will be duplicated. |
PurpleStringref* purple_stringref_new_noref | ( | const char * | value | ) |
Creates an immutable reference-counted string object.
The newly created object will have a reference count of zero, and if it is not referenced before the next iteration of the mainloop it will be freed at that time.
value | This will be the value of the string; it will be duplicated. |
PurpleStringref* purple_stringref_printf | ( | const char * | format, | |
... | ||||
) |
Creates an immutable reference-counted string object from a printf format specification and arguments.
The created object will have a reference count of 1.
format | A printf-style format specification. |
PurpleStringref* purple_stringref_ref | ( | PurpleStringref * | stringref | ) |
Increase the reference count of the given stringref.
stringref | String to be referenced. |
void purple_stringref_unref | ( | PurpleStringref * | stringref | ) |
Decrease the reference count of the given stringref.
If this reference count reaches zero, the stringref will be freed; thus you MUST NOT use this string after dereferencing it.
stringref | String to be dereferenced. |
const char* purple_stringref_value | ( | const PurpleStringref * | stringref | ) |
Retrieve the value of a stringref.
stringref | String reference from which to retrieve the value. |