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

Type: unsigned int

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

Return value

Type: 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.