FGXMLElement.h

/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 File:         FGXMLElement.h
 Author:       Jon S. Berndt
 Date started: 9/28/04
 
 ------------- Copyright (C) 2004  Jon S. Berndt (jon@jsbsim.org) -------------
 
 This program is free software; you can redistribute it and/or modify it under
 the terms of the GNU Lesser General Public License as published by the Free Software
 Foundation; either version 2 of the License, or (at your option) any later
 version.
 
 This program is distributed in the hope that it will be useful, but WITHOUT
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 details.
 
 You should have received a copy of the GNU Lesser General Public License along with
 this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 Place - Suite 330, Boston, MA  02111-1307, USA.
 
 Further information about the GNU Lesser General Public License can also be found on
 the world wide web at http://www.gnu.org.
 
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
SENTRY
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
#ifndef XMLELEMENT_H
#define XMLELEMENT_H
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
INCLUDES
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
#include <string>
#include <map>
#include <vector>
 
#include "simgear/structure/SGSharedPtr.hxx"
#include "math/FGColumnVector3.h"
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
FORWARD DECLARATIONS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
namespace JSBSim {
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
CLASS DOCUMENTATION
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
class Element;
typedef SGSharedPtr<Element> Element_ptr;
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
CLASS DECLARATION
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
class JSBSIM_API Element : public SGReferenced {
public:
  Element(const std::string& nm);
  ~Element(void);
 
  bool HasAttribute(const std::string& key) {return attributes.find(key) != attributes.end();}
 
  std::string GetAttributeValue(const std::string& key);
 
  bool SetAttributeValue(const std::string& key, const std::string& value);
 
  double GetAttributeValueAsNumber(const std::string& key);
 
  const std::string& GetName(void) const {return name;}
  void ChangeName(const std::string& _name) { name = _name; }
 
  std::string GetDataLine(unsigned int i=0);
 
  unsigned int GetNumDataLines(void) {return (unsigned int)data_lines.size();}
 
  unsigned int GetNumElements(void) {return (unsigned int)children.size();}
 
  unsigned int GetNumElements(const std::string& element_name);
 
  double GetDataAsNumber(void);
 
  Element* GetElement(unsigned int el=0);
 
  Element* GetNextElement(void);
 
  Element* GetParent(void) {return parent;}
 
  int GetLineNumber(void) const { return line_number; }
 
  const std::string& GetFileName(void) const { return file_name; }
 
  Element* FindElement(const std::string& el="");
 
  Element* FindNextElement(const std::string& el="");
 
  std::string FindElementValue(const std::string& el="");
 
  double FindElementValueAsNumber(const std::string& el="");
 
  bool FindElementValueAsBoolean(const std::string& el="");
  
  double FindElementValueAsNumberConvertTo(const std::string& el, const std::string& target_units);
 
  double FindElementValueAsNumberConvertFromTo( const std::string& el,
                                                const std::string& supplied_units,
                                                const std::string& target_units);
 
  FGColumnVector3 FindElementTripletConvertTo( const std::string& target_units);
 
  double DisperseValue(Element *e, double val, const std::string& supplied_units="",
                       const std::string& target_units="");
 
  void SetParent(Element* p) {parent = p;}
 
  void AddChildElement(Element* el) {children.push_back(el);}
 
  void AddAttribute(const std::string& name, const std::string& value);
 
  void AddData(std::string d);
 
  void Print(unsigned int level=0);
 
  void SetLineNumber(int line) { line_number = line; }
 
  void SetFileName(const std::string& name) { file_name = name; }
 
  std::string ReadFrom(void) const;
 
  void MergeAttributes(Element* el);
 
private:
  std::string name;
  std::map <std::string, std::string> attributes;
  std::vector <std::string> data_lines;
  std::vector <Element_ptr> children;
  Element *parent;
  unsigned int element_index;
  std::string file_name;
  int line_number;
  typedef std::map <std::string, std::map <std::string, double> > tMapConvert;
  static tMapConvert convert;
  static bool converterIsInitialized;
};
 
} // namespace JSBSim
 
//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
#endif