Function

Purplesavedstatuses_get_popular

Declaration [src]

GList*
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.

Parameters

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.