git.sesse.net Git - vlc/blob - 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 *, const char ** );
  74     const char *(*pf_next_attr) ( xml_reader_t *, const char ** );
  75
  76     int (*pf_use_dtd) ( xml_reader_t * );
  77 };
  78
  79 VLC_EXPORT( xml_reader_t *, xml_ReaderCreate, (vlc_object_t *, stream_t *) LIBVLC_USED );
  80 #define xml_ReaderCreate( a, s ) xml_ReaderCreate(VLC_OBJECT(a), s)
  81 VLC_EXPORT( void, xml_ReaderDelete, (xml_reader_t *) );
  82 VLC_EXPORT( xml_reader_t *, xml_ReaderReset, (xml_reader_t *, stream_t *) LIBVLC_USED );
  83
  84 static inline int xml_ReaderNextNode( xml_reader_t *reader, const char **pval )
  85 {
  86     return reader->pf_next_node( reader, pval );
  87 }
  88
  89 static inline const char *xml_ReaderNextAttr( xml_reader_t *reader,
  90                                               const char **pval )
  91 {
  92   return reader->pf_next_attr( reader, pval );
  93 }
  94
  95 static inline int xml_ReaderUseDTD( xml_reader_t *reader )
  96 {
  97   return reader->pf_use_dtd( reader );
  98 }
  99
 100 enum {
 101     XML_READER_NONE=0,
 102     XML_READER_STARTELEM,
 103     XML_READER_ENDELEM,
 104     XML_READER_TEXT,
 105 };
 106
 107 # ifdef __cplusplus
 108 }
 109 # endif
 110
 111 #endif