![]() |
![]() |
![]() |
GUPnP A/V Reference Manual | ![]() |
---|---|---|---|---|
UPnP AV DIDLLite Object handlingUPnP AV DIDLLite Object handling — Utility functions to deal with DIDL-Lite objects |
GList* gupnp_didl_lite_object_get_property (xmlNode *object_node, const char *property_name); char* gupnp_didl_lite_property_get_value (xmlNode *property_node); char* gupnp_didl_lite_property_get_attribute (xmlNode *property_node, const char *attribute); char* gupnp_didl_lite_object_get_id (xmlNode *object_node); char* gupnp_didl_lite_object_get_parent_id (xmlNode *object_node); gboolean gupnp_didl_lite_object_get_restricted (xmlNode *object_node); char* gupnp_didl_lite_object_get_title (xmlNode *object_node); char* gupnp_didl_lite_object_get_creator (xmlNode *object_node); char* gupnp_didl_lite_object_get_write_status (xmlNode *object_node); char* gupnp_didl_lite_object_get_upnp_class (xmlNode *object_node); char* gupnp_didl_lite_object_get_upnp_class_name (xmlNode *object_node); gboolean gupnp_didl_lite_object_is_container (xmlNode *object_node); gboolean gupnp_didl_lite_object_is_item (xmlNode *object_node); gboolean gupnp_didl_lite_container_get_searchable (xmlNode *container_node); guint gupnp_didl_lite_container_get_child_count (xmlNode *container_node); char* gupnp_didl_lite_item_get_ref_id (xmlNode *item_node);
A set of utility functions to ease the handling of DIDL-Lite object nodes.
Typically these functions will be used by an application in it's callback
function that it passes to gupnp_didl_lite_parser_parse_didl()
.
GList* gupnp_didl_lite_object_get_property (xmlNode *object_node, const char *property_name);
Use this function to retreive property nodes by name.
object_node : |
The object node |
property_name : |
name of the property |
Returns : | The list of property nodes by the name property_name
belonging to object_node , or NULL. g_list_free() the returned list after
usage but do not modify the contents.
|
char* gupnp_didl_lite_property_get_value (xmlNode *property_node);
property_node : |
The object property node |
Returns : | The value of the property node property_node as a string or
NULL. g_free() after usage.
|
char* gupnp_didl_lite_property_get_attribute (xmlNode *property_node, const char *attribute);
Use this function to retreive attributes of object properties.
property_node : |
The object property node |
attribute : |
name of the attribute |
Returns : | The value of the attribute attribute of the property node
property_node as a string or NULL. g_free() after usage.
|
char* gupnp_didl_lite_object_get_id (xmlNode *object_node);
object_node : |
The object node |
Returns : | The ID of the object_node , or NULL. g_free() after usage.
|
char* gupnp_didl_lite_object_get_parent_id (xmlNode *object_node);
object_node : |
The object node |
Returns : | The ID of parent of the object_node , or NULL. g_free() after
usage.
|
gboolean gupnp_didl_lite_object_get_restricted (xmlNode *object_node);
object_node : |
The object node |
Returns : | TRUE if object_node is restricted.
|
char* gupnp_didl_lite_object_get_title (xmlNode *object_node);
object_node : |
The object node |
Returns : | The title of the object_node , or NULL. g_free() after usage.
|
char* gupnp_didl_lite_object_get_creator (xmlNode *object_node);
object_node : |
The object node |
Returns : | The creator of the object_node , or NULL. g_free() after usage.
|
char* gupnp_didl_lite_object_get_write_status (xmlNode *object_node);
object_node : |
The object node |
Returns : | The write status of the object_node , or NULL. g_free() after
usage.
|
char* gupnp_didl_lite_object_get_upnp_class (xmlNode *object_node);
object_node : |
The object node |
Returns : | The class of object_node , or NULL. g_free() after usage.
|
char* gupnp_didl_lite_object_get_upnp_class_name (xmlNode *object_node);
object_node : |
The object node |
Returns : | The friendly name of the class of object_node , or NULL.
g_free() after usage.
|
gboolean gupnp_didl_lite_object_is_container (xmlNode *object_node);
object_node : |
The object node |
Returns : | TRUE if object_node is a container
|
gboolean gupnp_didl_lite_object_is_item (xmlNode *object_node);
object_node : |
The object node |
Returns : | TRUE if object_node is an item
|
gboolean gupnp_didl_lite_container_get_searchable (xmlNode *container_node);
container_node : |
The container node |
Returns : | TRUE if object_node is searchable
|
guint gupnp_didl_lite_container_get_child_count (xmlNode *container_node);
container_node : |
The container node |
Returns : | The child count of the container_node .
|