## 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.