GUPnPDIDLLiteParser

GUPnPDIDLLiteParser — A/V DIDL-Lite XML parser

Synopsis

                    GUPnPDIDLLiteParser;
GUPnPDIDLLiteParser* gupnp_didl_lite_parser_new         (void);
gboolean            gupnp_didl_lite_parser_parse_didl   (GUPnPDIDLLiteParser *parser,
                                                         const char *didl,
                                                         GError **error);

Object Hierarchy

  GObject
   +----GUPnPDIDLLiteParser

Signals

  "container-available"                            : Run Last
  "item-available"                                 : Run Last
  "object-available"                               : Run Last

Description

GUPnPDIDLLiteParser parses DIDL-Lite XML strings.

Details

GUPnPDIDLLiteParser

typedef struct _GUPnPDIDLLiteParser GUPnPDIDLLiteParser;

gupnp_didl_lite_parser_new ()

GUPnPDIDLLiteParser* gupnp_didl_lite_parser_new         (void);

Returns : A new GUPnPDIDLLiteParser object.

gupnp_didl_lite_parser_parse_didl ()

gboolean            gupnp_didl_lite_parser_parse_didl   (GUPnPDIDLLiteParser *parser,
                                                         const char *didl,
                                                         GError **error);

Parses DIDL-Lite XML string didl, emitting the ::object-available, ::item-available and ::container-available signals appropriately during the process.

parser : A GUPnPDIDLLiteParser
didl : The DIDL-Lite XML string to be parsed
error : The location where to store any error, or NULL
Returns : TRUE on success.

Signal Details

The "container-available" signal

void                user_function                      (GUPnPDIDLLiteParser    *parser,
                                                        GUPnPDIDLLiteContainer *container,
                                                        gpointer                user_data)      : Run Last

The ::container-available signal is emitted each time a container is found in the DIDL-Lite XML being parsed.

parser : The GUPnPDIDLLiteParser that received the signal
container : The now available GUPnPDIDLLiteContainer
user_data : user data set when the signal handler was connected.

The "item-available" signal

void                user_function                      (GUPnPDIDLLiteParser *parser,
                                                        GUPnPDIDLLiteItem   *item,
                                                        gpointer             user_data)      : Run Last

The ::item-available signal is emitted each time an item is found in the DIDL-Lite XML being parsed.

parser : The GUPnPDIDLLiteParser that received the signal
item : The now available GUPnPDIDLLiteItem
user_data : user data set when the signal handler was connected.

The "object-available" signal

void                user_function                      (GUPnPDIDLLiteParser *parser,
                                                        GUPnPDIDLLiteObject *object,
                                                        gpointer             user_data)      : Run Last

The ::object-available signal is emitted each time an object is found in the DIDL-Lite XML being parsed.

parser : The GUPnPDIDLLiteParser that received the signal
object : The now available GUPnPDIDLLiteObject
user_data : user data set when the signal handler was connected.