diff src/stringref.h @ 7767:1f4005fcd872

[gaim-migrate @ 8412] As Nathan pointed out, a printf'd stringref is probably desirable committer: Tailor Script <[e-mail]>

--- a/src/stringref.h	Fri Dec 05 17:09:18 2003 +0000
+++ b/src/stringref.h	Fri Dec 05 17:28:22 2003 +0000
@@ -42,11 +42,24 @@
  * @param value This will be the value of the string; it will be
  *              duplicated.
  *
- * @return A newly allocated string reference object.
+ * @return A newly allocated string reference object with a refcount
+ *         of 1.
  */
 GaimStringref *gaim_stringref_new(const char *value);
 
 /**
+ * Creates an immutable reference-counted string object from a printf
+ * format specification and arguments.  The created object will have a
+ * reference count of 1.
+ *
+ * @param format A printf-style format specification.
+ *
+ * @return A newly allocated string reference object with a refcount
+ *         of 1.
+ */
+GaimStringref *gaim_stringref_printf(const char *format, ...);
+
+/**
  * Increase the reference count of the given stringref.
  *
  * @param stringref String to be referenced.