Declaration [src]

purple_savedstatuses_get_popular (
  unsigned int how_many

Description [src]

Returns the n most popular saved statuses. “Popularity” is determined by when the last time a saved_status was used and how many times it has been used. Transient statuses without messages are not included in the list.


how_many unsigned int

The maximum number of saved statuses to return, or ‘0’ to get all saved statuses sorted by popularity.

Return value

Returns: A list of PurpleSavedStatus*

A list containing at most how_many saved statuses.

 The caller of the function takes ownership of the data container, but not the data inside it.