Top |
This is a dumping ground for utility functions that may or may not be generally useful in Rhythmbox or elsewhere. Things end up here if they're clever or if they're used all over the place.
gboolean
rb_true_function (gpointer dummy
);
Just returns TRUE
, useful as a callback function.
[skip]
gboolean
rb_false_function (gpointer dummy
);
Just returns FALSE
, useful as a callback function.
[skip]
gpointer
rb_null_function (gpointer dummy
);
Just returns NULL. Useful as a callback function.
[skip]
gpointer
rb_copy_function (gpointer data
);
Just returns its first argument. Useful as a callback function.
[skip]
int rb_gvalue_compare (GValue *a
,GValue *b
);
Compares a
and b
for sorting. a
and b
must contain the same value
type for the comparison to be valid. Comparisons for some value types
are not particularly useful.
[skip]
int rb_compare_gtimeval (GTimeVal *a
,GTimeVal *b
);
Compares two GTimeVal structures for sorting.
char *
rb_make_time_string (guint seconds
);
Constructs a string describing the specified time.
char *
rb_make_duration_string (guint duration
);
Constructs a string describing the specified duration. The string describes hours, minutes, and seconds, and its format is localised.
char * rb_make_elapsed_time_string (guint elapsed
,guint duration
,gboolean show_remaining
);
Constructs a string describing a playback position. The string describes hours, minutes, and seconds, and its format is localised. The string can describe either the elapsed time or the time remaining.
elapsed |
elapsed time (in seconds) |
|
duration |
duration (in seconds) |
|
show_remaining |
if |
void
rb_threads_init (void
);
Initializes various thread helpers. Must be called on startup.
[skip]
gboolean
rb_is_main_thread (void
);
Checks if currently executing on the main thread.
gchar *
rb_search_fold (const char *original
);
Returns a case-folded and punctuation-stripped version of original
, useful
for performing text searches.
gchar **
rb_string_split_words (const gchar *string
);
Splits string
on word boundaries using Unicode character definitions.
gboolean rb_string_list_equal (GList *a
,GList *b
);
Checks if a
and b
contain exactly the same set of strings,
regardless of order.
[skip]
a |
list of strings to compare. |
[element-type utf8] |
b |
other list of strings to compare. |
[element-type utf8] |
gboolean rb_string_list_contains (GList *list
,const char *s
);
Checks if list
contains the string s
.
[skip]
GList *
rb_string_list_copy (GList *list
);
Creates a deep copy of list
.
[skip]
void
rb_list_deep_free (GList *list
);
Frees each element of list
and list
itself.
[skip]
void rb_list_destroy_free (GList *list
,GDestroyNotify destroyer
);
Calls destroyer
for each element in list
, then frees list
.
[skip]
void
rb_slist_deep_free (GSList *list
);
Frees each element of list
and list
itself.
[skip]
gboolean rb_str_in_strv (const char *needle
,const char **haystack
);
Checks if needle
is present in the NULL-terminated string
array haystack
.
[skip]
GList *
rb_collate_hash_table_keys (GHashTable *table
);
Returns a GList containing all keys from table
. The keys are
not copied.
[skip]
GList *
rb_collate_hash_table_values (GHashTable *table
);
Returns a GList containing all values from table
. The values are
not copied.
[skip]
GList *
rb_uri_list_parse (const char *uri_list
);
Converts a single string containing a list of URIs into a GList of URI strings.
gboolean rb_signal_accumulator_object_handled (GSignalInvocationHint *hint
,GValue *return_accu
,const GValue *handler_return
,gpointer dummy
);
A GSignalAccumulator that aborts the signal emission after the first handler to return a value, and returns the value returned by that handler. This is the opposite behaviour from what you get when no accumulator is specified, where the last signal handler wins.
[skip]
gboolean rb_signal_accumulator_value_handled (GSignalInvocationHint *hint
,GValue *return_accu
,const GValue *handler_return
,gpointer dummy
);
A GSignalAccumulator that aborts the signal emission after the first handler to return a value, and returns the value returned by that handler. This is the opposite behaviour from what you get when no accumulator is specified, where the last signal handler wins.
[skip]
gboolean rb_signal_accumulator_boolean_or (GSignalInvocationHint *hint
,GValue *return_accu
,const GValue *handler_return
,gpointer dummy
);
A GSignalAccumulator used to return the boolean OR of all returned (boolean) values.
[skip]
gboolean rb_signal_accumulator_value_array (GSignalInvocationHint *hint
,GValue *return_accu
,const GValue *handler_return
,gpointer dummy
);
A GSignalAccumulator used to combine all returned values into a GArray of GValue instances.
[skip]
void rb_value_array_append_data (GArray *array
,GType type
,...
);
Appends a single value to array
, collecting it from Varargs
.
[skip]
void
rb_value_free (GValue *val
);
Unsets and frees val
. val
must have been allocated using
g_slice_new
or g_slice_new0
.
[skip]
void
rb_assert_locked (GMutex *mutex
);
Asserts that mutex
is currently locked. Does not work with all
mutex implementations.
[skip]
void rb_set_tree_view_column_fixed_width (GtkWidget *treeview
,GtkTreeViewColumn *column
,GtkCellRenderer *renderer
,const char **strings
,int padding
);
Sets a fixed size for a tree view column based on a set of strings to be displayed in the column.
treeview |
the GtkTreeView containing the column |
|
column |
the GtkTreeViewColumn to size |
|
renderer |
the GtkCellRenderer used in the column |
|
strings |
a NULL-terminated set of strings to base the size on. |
[array zero-terminated=1] |
padding |
a small amount of extra padding for the column |
GdkPixbuf * rb_scale_pixbuf_to_size (GdkPixbuf *pixbuf
,GtkIconSize size
);
Creates a new GdkPixbuf from the original one, for a target of size, respecting the aspect ratio of the image.
void rb_settings_delayed_sync (GSettings *settings
,RBDelayedSyncFunc sync_func
,gpointer data
,GDestroyNotify destroy
);
Synchronizes settings in the settings
instance after 500ms has elapsed
with no further changes.
settings |
GSettings instance |
|
sync_func |
function to call. |
[allow-none] |
data |
data to pass to |
[allow-none] |
destroy |
function to use to free |
[allow-none] |
void rb_menu_update_link (GMenu *menu
,const char *link_attr
,GMenuModel *target
);
Updates a submenu link to point to the specified target menu.