src/savedstatuses.h

changeset 12690
4a93889c7593
parent 12688
d2beaf15f294
child 12857
2e99b4a360fc
equal deleted inserted replaced
12689:face848077fb 12690:4a93889c7593
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.

mercurial