Get the next entry from a playlist
#include <mm/mmplaylist.h>
int mmplaylist_entry_next_get(mmplaylist_t *pl, mmplaylist_entry_t **entry)
This function gets the next entry from a playlist. The data structure filled in by this function contains the next entry from the playlist file and a flag field that describes the properties of this entry.
This last step repeats until either the callback determines that the entry is valid or the playlist manager has iterated through the character conversion and/or validation routines. At this point, the function returns the raw entry to the caller.
Callers must use mmplaylist_entry_release() to free the memory for a playlist entry when they're done with it. They must not free the memory themselves; doing so will result in unpredictable behavior.
1 The entry was successfully retrieved.
0 The end of the playlist was reached.
-1 An error occurred (call mmplaylist_last_error_get() for details).