Get the next entry from a playlist.
#include <mm/mmplaylist.h>
int mmplaylist_entry_next_get( mmplaylist_t *pl, mmplaylist_entry_t **entry )
Get 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 on success (the entry was retrieved)
0 on end of playlist
-1 on error (use mmplaylist_last_error_get() to get error information)