mmplaylist_pl_validation_fn_t

Prototype for the plugin validation function

Synopsis:

#include <mm/mmplaylist.h>
typedef int mmplaylist_pl_validation_fn_t(char *raw,
                                          char *encoded,
                                          void *cbk_data);

Library:

libmmplaylist

Description:

The mmplaylist_pl_validation_fn_t data type specifies the prototype for a function that validates plugin names. This optional function can be defined to override a plugin's default validation function. It will try to validate which entry name is correct: the raw name or the UTF-8 one. See the mmplaylist_entry_next_get() description for an explanation of playlist entry validation.

This type of function takes three parameters:
  • raw, which contains the raw entry name being proposed as resolved
  • encoded, which contains the UTF-8 entry name being proposed as resolved
  • cbk_data, which stores a pointer to data for the callback (validation) function

Returns:

An MMPLAYLIST_PL_ENTRY_* constant indicating the outcome of the validation or that the validation attempt failed.