Function

Purpleutil_format_song_info

Declaration [src]

char*
purple_util_format_song_info (
  const char* title,
  const char* artist,
  const char* album,
  gpointer unused
)

Description [src]

Format song information.

Parameters

title const char*
 

The title of the song, NULL to unset the value.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
artist const char*
 

The artist of the song, can be NULL.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
album const char*
 

The album of the song, can be NULL.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
unused gpointer
 

Currently unused, must be NULL.

 The argument can be NULL.
 The data is owned by the caller of the function.

Return value

Returns: char*
 

The formatted string. The caller must g_free the returned string.

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The value is a NUL terminated UTF-8 string.