uxmlparser.hpp

/* ==================================================== ======== ======= *
 *
 *  uxmlparser.hpp
 *  Ubit GUI Toolkit - Version 6
 *  (C) 2009 / Eric Lecolinet / Telecom ParisTech / http://www.enst.fr/~elc/ubit
 *
 * ***********************************************************************
 * COPYRIGHT NOTICE :
 * THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY AND WITHOUT EVEN THE
 * IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 * YOU CAN REDISTRIBUTE IT AND/OR MODIFY IT UNDER THE TERMS OF THE GNU
 * GENERAL PUBLIC LICENSE AS PUBLISHED BY THE FREE SOFTWARE FOUNDATION;
 * EITHER VERSION 2 OF THE LICENSE, OR (AT YOUR OPTION) ANY LATER VERSION.
 * SEE FILES 'COPYRIGHT' AND 'COPYING' FOR MORE DETAILS.
 * ***********************************************************************/

#ifndef _uxmlparser_hpp_
#define _uxmlparser_hpp_ 1
#include <ubit/udom.hpp>
#include <fstream>
namespace ubit {
    
  class UXmlGrammar;
  
  class UXmlParser {
  public:
    struct ParseError {};
    
    UXmlParser();
    
    virtual ~UXmlParser();
    
    void addGrammar(const UXmlGrammar&);
    UXmlDocument* read(const UStr& path);
    UXmlDocument* readBuffer(const UStr& docname, const UStr& buffer) 
    {return parse(docname,buffer);}
    
    UXmlDocument* parse(const UStr& docname, const UStr& buffer);
    int getStatus() {return status;}
    
    UErrorHandler* getErrorHandler() {return perrhandler;}
 
    void setErrorHandler(UErrorHandler* eh) {perrhandler = eh;}
    
    void setPermissive(bool b) {permissive = b;}
    void setCollapseSpaces(bool b) {collapse_spaces = b;}
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  protected:
    void readElement(UElem* parent);
    void readText(UElem* parent);
    bool readXMLDeclaration();
    void readXMLInstruction(UElem* parent);
    void readSGMLData(UElem* parent);
    
    void skipSpaces();
    UChar readCharEntityReference();
    bool readName(UStr&);
    bool readQuotedValue(UStr&, UChar quoting_char);
    bool readUnquotedValue(UStr&);
    bool readNameValuePair(UStr& name, UStr& value);
    UElem* readElementStartTag(UStr& elem_name, int& stat);
    int  readElementEndTag(const UStr& elem_name);
    
    void error(const char* msg, const UChar* line);
    void error(const char* msg_start, const UStr& name,
               const char* msg_end, const UChar* line);
    void unexpected(const char* msg, const UChar* line);
    
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
  private:
    static const int INVALID_TAG = 0, END_TAG = 1, END_TAG_AND_ELEM = 2;
    int status;
    bool permissive, collapse_spaces;
    const UChar *text_buffer, *p;
    UXmlDocument* doc;
    UXmlGrammars* parser_grammars;
    uptr<UErrorHandler> perrhandler;
  };
}
#endif