| 189 * @return The saved status if found, or NULL. |
189 * @return The saved status if found, or NULL. |
| 190 */ |
190 */ |
| 191 GaimSavedStatus *gaim_savedstatus_find(const char *title); |
191 GaimSavedStatus *gaim_savedstatus_find(const char *title); |
| 192 |
192 |
| 193 /** |
193 /** |
| |
194 * Finds a saved status with the specified creation time. |
| |
195 * |
| |
196 * @param creation_time The timestamp when the saved |
| |
197 * status was created. |
| |
198 * |
| |
199 * @return The saved status if found, or NULL. |
| |
200 */ |
| |
201 GaimSavedStatus *gaim_savedstatus_find_by_creation_time(time_t creation_time); |
| |
202 |
| |
203 /** |
| 194 * Determines if a given saved status is "transient." |
204 * Determines if a given saved status is "transient." |
| 195 * A transient saved status is one that was not |
205 * A transient saved status is one that was not |
| 196 * explicitly added by the user. Transient statuses |
206 * explicitly added by the user. Transient statuses |
| 197 * are automatically removed if they are not used |
207 * are automatically removed if they are not used |
| 198 * for a period of time. |
208 * for a period of time. |
| 212 /** |
222 /** |
| 213 * Return the name of a given saved status. |
223 * Return the name of a given saved status. |
| 214 * |
224 * |
| 215 * @param saved_status The saved status. |
225 * @param saved_status The saved status. |
| 216 * |
226 * |
| 217 * @return The title. |
227 * @return The title. This value may be a static buffer which may |
| |
228 * be overwritten on subsequent calls to this function. If |
| |
229 * you need a reference to the title for prolonged use then |
| |
230 * you should make a copy of it. |
| 218 */ |
231 */ |
| 219 const char *gaim_savedstatus_get_title(const GaimSavedStatus *saved_status); |
232 const char *gaim_savedstatus_get_title(const GaimSavedStatus *saved_status); |
| 220 |
233 |
| 221 /** |
234 /** |
| 222 * Return the type of a given saved status. |
235 * Return the type of a given saved status. |