]> git.sesse.net Git - vlc/blob - include/vlc_xml.h
XML: merge read and node_type operations, skip unknown nodes
[vlc] / include / vlc_xml.h
1 /*****************************************************************************
2 * xml.h: XML abstraction layer
3 *****************************************************************************
4 * Copyright (C) 2004-2010 the VideoLAN team
5 *
6 * Author: Gildas Bazin <gbazin@videolan.org>
7 *
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.
12 *
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.
17 *
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 *****************************************************************************/
22
23 #ifndef VLC_XML_H
24 #define VLC_XML_H
25
26 /**
27 * \file
28 * This file defines functions and structures to handle xml tags in vlc
29 *
30 */
31
32 # ifdef __cplusplus
33 extern "C" {
34 # endif
35
36 struct xml_t
37 {
38     VLC_COMMON_MEMBERS
39
40     /* Module properties */
41     module_t  *p_module;
42     xml_sys_t *p_sys;
43
44     void (*pf_catalog_load) ( xml_t *, const char * );
45     void (*pf_catalog_add) ( xml_t *, const char *, const char *,
46                             const char * );
47 };
48
49 VLC_EXPORT( xml_t *, xml_Create, ( vlc_object_t * ) LIBVLC_USED );
50 #define xml_Create( a ) xml_Create( VLC_OBJECT(a) )
51 VLC_EXPORT( void, xml_Delete, ( xml_t * ) );
52
53 static inline void xml_CatalogLoad( xml_t *xml, const char *catalog )
54 {
55     xml->pf_catalog_load( xml, catalog );
56 }
57
58 static inline void xml_CatalogAdd( xml_t *xml, const char *type,
59                                    const char *orig, const char *value )
60 {
61     xml->pf_catalog_add( xml, type, orig, value );
62 }
63
64
65 struct xml_reader_t
66 {
67     VLC_COMMON_MEMBERS
68
69     xml_reader_sys_t *p_sys;
70     stream_t *p_stream;
71     module_t *p_module;
72
73     int (*pf_next_node) ( xml_reader_t * );
74     char * (*pf_name) ( xml_reader_t * );
75     char * (*pf_value) ( xml_reader_t * );
76     int (*pf_next_attr) ( xml_reader_t * );
77
78     int (*pf_use_dtd) ( xml_reader_t * );
79 };
80
81 VLC_EXPORT( xml_reader_t *, xml_ReaderCreate, (vlc_object_t *, stream_t *) LIBVLC_USED );
82 #define xml_ReaderCreate( a, s ) xml_ReaderCreate(VLC_OBJECT(a), s)
83 VLC_EXPORT( void, xml_ReaderDelete, (xml_reader_t *) );
84 VLC_EXPORT( xml_reader_t *, xml_ReaderReset, (xml_reader_t *, stream_t *) LIBVLC_USED );
85
86 static inline int xml_ReaderNextNode( xml_reader_t *reader )
87 {
88   return reader->pf_next_node( reader );
89 }
90
91 static inline char *xml_ReaderName( xml_reader_t *reader )
92 {
93   return reader->pf_name( reader );
94 }
95
96 static inline char *xml_ReaderValue( xml_reader_t *reader )
97 {
98   return reader->pf_value( reader );
99 }
100
101 static inline int xml_ReaderNextAttr( xml_reader_t *reader )
102 {
103   return reader->pf_next_attr( reader );
104 }
105
106 static inline int xml_ReaderUseDTD( xml_reader_t *reader )
107 {
108   return reader->pf_use_dtd( reader );
109 }
110
111 enum {
112     XML_READER_NONE=0,
113     XML_READER_STARTELEM,
114     XML_READER_ENDELEM,
115     XML_READER_TEXT,
116 };
117
118 # ifdef __cplusplus
119 }
120 # endif
121
122 #endif