comparison src/stringref.h @ 7791:21be2d9e8399

[gaim-migrate @ 8437] what I came up with while disconnected committer: Tailor Script <[e-mail]>

7790:c2e391c480b6

 * @note For this structure to be useful, the string contained within
 * it must be immutable -- for this reason, do _not_ access it
 * directly!
 */
typedef struct _GaimStringref {
	unsigned int ref;	/**< The reference count of this string.
	                         *   Note that reference counts are only
				 *   31 bits, and the high-order bit
				 *   indicates whether this string is up
				 *   for GC at the next idle handler...
				 *   But you aren't going to touch this
				 *   anyway, right? */
	char value[0];		/**< The string contained in this ref.
	                         *   Notice that it is simply "hanging
				 *   off the end" of the ref ... this
				 *   is to save an allocation. */
} GaimStringref;

/**
 * Creates an immutable reference-counted string object.  The newly
 * created object will have a reference count of 1.

7791:21be2d9e8399

 * @note For this structure to be useful, the string contained within
 * it must be immutable -- for this reason, do _not_ access it
 * directly!
 */
typedef struct _GaimStringref {
	guint32 ref;	/**< The reference count of this string.
					 *   Note that reference counts are only
					 *   31 bits, and the high-order bit
					 *   indicates whether this string is up
					 *   for GC at the next idle handler...
					 *   But you aren't going to touch this
					 *   anyway, right? */
	char value[0];	/**< The string contained in this ref.
					 *   Notice that it is simply "hanging
					 *   off the end" of the ref ... this
					 *   is to save an allocation. */
} GaimStringref;

/**
 * Creates an immutable reference-counted string object.  The newly
 * created object will have a reference count of 1.