1 /*****************************************************************************
2 * xml.c: XML parser wrapper for XML modules
3 *****************************************************************************
4 * Copyright (C) 2004-2010 the VideoLAN team
6 * Authors: Gildas Bazin <gbazin@videolan.org>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
21 *****************************************************************************/
27 #include <vlc_common.h>
29 #include <vlc_modules.h>
30 #include "../libvlc.h"
33 /*****************************************************************************
35 *****************************************************************************
36 * Create an instance of an XML parser.
37 * Returns NULL on error.
38 *****************************************************************************/
39 xml_t *xml_Create( vlc_object_t *p_this )
43 p_xml = vlc_custom_create( p_this, sizeof( *p_xml ), VLC_OBJECT_GENERIC,
45 vlc_object_attach( p_xml, p_this );
47 p_xml->p_module = module_need( p_xml, "xml", NULL, false );
48 if( !p_xml->p_module )
50 vlc_object_release( p_xml );
51 msg_Err( p_this, "XML provider not found" );
58 /*****************************************************************************
59 * xml_Delete: Deletes an instance of xml_t
60 *****************************************************************************/
61 void xml_Delete( xml_t *p_xml )
63 module_unneed( p_xml, p_xml->p_module );
64 vlc_object_release( p_xml );
68 #undef xml_ReaderCreate
70 * Creates an XML reader.
71 * @param obj parent VLC object
72 * @param stream stream to read XML from
73 * @return NULL on error.
75 xml_reader_t *xml_ReaderCreate(vlc_object_t *obj, stream_t *stream)
79 reader = vlc_custom_create(obj, sizeof(*reader), VLC_OBJECT_GENERIC,
81 vlc_object_attach(reader, obj);
83 reader->p_stream = stream;
84 reader->p_module = module_need(reader, "xml reader", NULL, false);
85 if (unlikely(reader->p_module == NULL))
87 msg_Err(reader, "XML reader not found");
88 vlc_object_release(reader);
96 * Deletes an XML reader.
97 * @param reader XML reader created with xml_RaederCreate().
99 void xml_ReaderDelete(xml_reader_t *reader)
101 module_unneed(reader, reader->p_module);
102 vlc_object_release(reader);
107 * Resets an existing XML reader.
108 * If you need to parse several XML files, this function is much faster than
109 * xml_ReaderCreate() and xml_ReaderDelete() combined.
110 * @param reader XML reader to reinitialize
111 * @param stream new stream to read XML data from
112 * @return reader on success, NULL on error (in that case, the reader is
115 xml_reader_t *xml_ReaderReset(xml_reader_t *reader, stream_t *stream)
117 module_stop(reader, reader->p_module);
119 reader->p_stream = stream;
120 if (module_start(reader, reader->p_module))
122 vlc_object_release(reader);