Teuchos_TreeBuildingXMLHandler.hpp

Go to the documentation of this file.

// @HEADER
// *****************************************************************************
//                    Teuchos: Common Tools Package
//
// Copyright 2004 NTESS and the Teuchos contributors.
// SPDX-License-Identifier: BSD-3-Clause
// *****************************************************************************
// @HEADER
 
#ifndef Teuchos_TREEBUILDINGXMLHANDLER_H
#define Teuchos_TREEBUILDINGXMLHANDLER_H

 
#include "Teuchos_ConfigDefs.hpp"
#include "Teuchos_XMLObject.hpp"
#include <list>
#include <stack>
 
 
namespace Teuchos
{

  class TreeBuildingXMLHandler
    {
      typedef Teuchos::map<std::string, std::string> Map;
    public:
      TreeBuildingXMLHandler();

      const XMLObject& getObject() const
        {
          // valid XML requires a root object; we will allow empty XML files
          TEUCHOS_TEST_FOR_EXCEPTION(
            root_.isEmpty(), EmptyXMLError
            ,"Error, An empty XML std::string or file was specified!"
            "  The XML specification requires at minimum the presence"
            " of a root element!" );
          return root_.getChild(0);
        }

      void characters(const std::string& chars);

      int endElement(const std::string& tag);

      void startElement(const std::string& tag,
                        const Map& attributes);
 
    private:
      XMLObject root_;
      XMLObject current_;
      std::stack<XMLObject> path_;
    };
}
 
 
#endif