comparison: libpurple/stringref.h
libpurple/stringref.h
- changeset 40186
- d7e2aba4d9f4
- parent 39659
- e4dfb99b0cef
- child 40188
- 80e78796edb2
equal
deleted
inserted
replaced
| 40079:a37a1e349491 | 40186:d7e2aba4d9f4 |
|---|---|
| 41 * duplicated. | 41 * duplicated. |
| 42 * | 42 * |
| 43 * Creates an immutable reference-counted string object. The newly | 43 * Creates an immutable reference-counted string object. The newly |
| 44 * created object will have a reference count of 1. | 44 * created object will have a reference count of 1. |
| 45 * | 45 * |
| 46 * Returns: A newly allocated string reference object with a refcount | 46 * Returns: (skip) (transfer full): A newly allocated string reference object with a refcount |
| 47 * of 1. | 47 * of 1. |
| 48 */ | 48 */ |
| 49 PurpleStringref *purple_stringref_new(const char *value); | 49 PurpleStringref *purple_stringref_new(const char *value); |
| 50 | 50 |
| 51 /** | 51 /** |
| 56 * Creates an immutable reference-counted string object. The newly | 56 * Creates an immutable reference-counted string object. The newly |
| 57 * created object will have a reference count of zero, and if it is | 57 * created object will have a reference count of zero, and if it is |
| 58 * not referenced before the next iteration of the mainloop it will | 58 * not referenced before the next iteration of the mainloop it will |
| 59 * be freed at that time. | 59 * be freed at that time. |
| 60 * | 60 * |
| 61 * Returns: A newly allocated string reference object with a refcount | 61 * Returns: (skip) (transfer full): A newly allocated string reference object with a refcount |
| 62 * of zero. | 62 * of zero. |
| 63 */ | 63 */ |
| 64 PurpleStringref *purple_stringref_new_noref(const char *value); | 64 PurpleStringref *purple_stringref_new_noref(const char *value); |
| 65 | 65 |
| 66 /** | 66 /** |
| 70 * | 70 * |
| 71 * Creates an immutable reference-counted string object from a printf | 71 * Creates an immutable reference-counted string object from a printf |
| 72 * format specification and arguments. The created object will have a | 72 * format specification and arguments. The created object will have a |
| 73 * reference count of 1. | 73 * reference count of 1. |
| 74 * | 74 * |
| 75 * Returns: A newly allocated string reference object with a refcount | 75 * Returns: (skip): A newly allocated string reference object with a refcount |
| 76 * of 1. | 76 * of 1. |
| 77 */ | 77 */ |
| 78 PurpleStringref *purple_stringref_printf(const char *format, ...); | 78 PurpleStringref *purple_stringref_printf(const char *format, ...); |
| 79 | 79 |
| 80 /** | 80 /** |
| 81 * purple_stringref_ref: | 81 * purple_stringref_ref: |
| 82 * @stringref: String to be referenced. | 82 * @stringref: String to be referenced. |
| 83 * | 83 * |
| 84 * Increase the reference count of the given stringref. | 84 * Increase the reference count of the given stringref. |
| 85 * | 85 * |
| 86 * Returns: A pointer to the referenced string. | 86 * Returns: (skip) (transfer full): A pointer to the referenced string. |
| 87 */ | 87 */ |
| 88 PurpleStringref *purple_stringref_ref(PurpleStringref *stringref); | 88 PurpleStringref *purple_stringref_ref(PurpleStringref *stringref); |
| 89 | 89 |
| 90 /** | 90 /** |
| 91 * purple_stringref_unref: | 91 * purple_stringref_unref: |
