Go to the source code of this file.
Data Structures | |
struct | _GaimStringref |
The internal representation of a stringref. More... | |
Typedefs | |
typedef _GaimStringref | GaimStringref |
The internal representation of a stringref. | |
Functions | |
GaimStringref * | gaim_stringref_new (const char *value) |
Creates an immutable reference-counted string object. | |
GaimStringref * | gaim_stringref_new_noref (const char *value) |
Creates an immutable reference-counted string object. | |
GaimStringref * | gaim_stringref_printf (const char *format,...) |
Creates an immutable reference-counted string object from a printf format specification and arguments. | |
GaimStringref * | gaim_stringref_ref (GaimStringref *stringref) |
Increase the reference count of the given stringref. | |
void | gaim_stringref_unref (GaimStringref *stringref) |
Decrease the reference count of the given stringref. | |
const char * | gaim_stringref_value (const GaimStringref *stringref) |
Retrieve the value of a stringref. | |
int | gaim_stringref_cmp (const GaimStringref *s1, const GaimStringref *s2) |
Compare two stringrefs for string equality. | |
size_t | gaim_stringref_len (const GaimStringref *stringref) |
Find the length of the string inside a stringref. |
gaim
Gaim is the legal property of its developers, whose names are too numerous to list here. Please refer to the COPYRIGHT file distributed with this source distribution.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
typedef struct _GaimStringref GaimStringref |
The internal representation of a stringref.
int gaim_stringref_cmp | ( | const GaimStringref * | s1, | |
const GaimStringref * | 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 gaim_stringref_len | ( | const GaimStringref * | stringref | ) |
Find the length of the string inside a stringref.
stringref | The string in whose length we are interested. |
GaimStringref* gaim_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. |
GaimStringref* gaim_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. |
GaimStringref* gaim_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. |
GaimStringref* gaim_stringref_ref | ( | GaimStringref * | stringref | ) |
Increase the reference count of the given stringref.
stringref | String to be referenced. |
void gaim_stringref_unref | ( | GaimStringref * | 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* gaim_stringref_value | ( | const GaimStringref * | stringref | ) |
Retrieve the value of a stringref.
stringref | String reference from which to retrieve the value. |