uxmlparser.hpp

/* ==================================================== ======== ======= *
*
*  uxmlparser.hpp
*  Ubit Project
*  Part of the Ubit Toolkit: A Brick Construction Game Model for Creating GUIs
*  (C) 1999-2005 EricLecolinet / ENST Paris / 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.
* ***********************************************************************
* ==================================================== [(c)Elc] ======= *
* ==================================================== ======== ======= */

//pragma ident  "@(#)uxmlparser.hpp ubit:05.05.00"
#ifndef _uxmlparser_hpp_
#define _uxmlparser_hpp_
#include <ubit/udom.hpp>
#include <fstream>
namespace ubit {

class UXmlGrammar;

/* ==================================================== [Elc] ======= */
/* ==================================================== ===== ======= */
class UXmlParser {
public:
  struct ParseError {};

  UXmlParser();
  
  virtual ~UXmlParser();

  void addGrammar(const UXmlGrammar&);
  void setPermissive(bool b) {permissive = b;}
  void setCollapseSpaces(bool b) {collapse_spaces = b;}
  UXmlDoc* read(const UStr& pathname);
  UXmlDoc* parse(const UStr& doc_name, const UStr& doc_text);
  int getStatus() {return stat;}
  
  void setErrorOutput(UStr& error_buffer);

  void setErrorOutput(std::ostream&);

  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

protected:
  void readElement(UGroup* parent);
  void readText(UGroup* parent);
  bool readXMLDeclaration();
  void readXMLInstruction(UGroup* parent);
  void readSGMLData(UGroup* parent);

  void skipSpaces();
  UChar readCharEntityReference();
  bool readName(UStr&);
  bool readQuotedValue(UStr&, UChar quoting_char);
  bool readUnquotedValue(UStr&);
  bool readNameValuePair(UStr& name, UStr& value);
  UGroup* 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 stat;
  bool permissive, collapse_spaces;
  const UChar *text_buffer, *p;
  UXmlDoc* doc;
  uptr<UStr> sout;
  std::ostream* fout;
  UXmlGrammars* parser_grammars;
};
}
#endif
/* ==================================================== [(c)Elc] ======= */
/* ==================================================== ======== ======= */

---