OCCT

// Created on: 2001-06-26
// Created by: Alexander GRIGORIEV
// Copyright (c) 2001-2014 OPEN CASCADE SAS
//
// This file is part of Open CASCADE Technology software library.
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Lesser General Public License version 2.1 as published
// by the Free Software Foundation, with special exception defined in the file
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
// distribution for complete text of the license and disclaimer of any warranty.
//
// Alternatively, this file may be used under the terms of Open CASCADE
// commercial license or contractual agreement.

// AGV 140202: Repl.(const char *) for (LDOMBasicString) => myTagName

#ifndef LDOM_BasicElement_HeaderFile
#define LDOM_BasicElement_HeaderFile

#include <LDOM_BasicNode.hxx>
#include <LDOMBasicString.hxx>
#include <LDOM_Node.hxx>

class LDOM_NodeList;
class LDOM_BasicAttribute;

//  Class LDOM_BasicElement
//

class LDOM_BasicElement : public LDOM_BasicNode
{
public:
  // ---------- PUBLIC METHODS ----------

  LDOM_BasicElement()
      : LDOM_BasicNode(LDOM_Node::UNKNOWN),
        myTagName(nullptr),
        myAttributeMask(0),
        myFirstChild(nullptr)
  {
  }

  //    Empty constructor

  static LDOM_BasicElement& Create(const char*                         aName,
                                   const int                           aLength,
                                   const occ::handle<LDOM_MemManager>& aDoc);

  //  Standard_EXPORT LDOM_BasicElement (const LDOM_BasicElement& theOther);
  //    Copy constructor

  Standard_EXPORT LDOM_BasicElement& operator=(const LDOM_NullPtr* aNull);
  //    Nullify

  Standard_EXPORT ~LDOM_BasicElement();

  //    Destructor

  const char* GetTagName() const { return myTagName; }

  const LDOM_BasicNode* GetFirstChild() const { return myFirstChild; }

  Standard_EXPORT const LDOM_BasicNode* GetLastChild() const;

  Standard_EXPORT const LDOM_BasicAttribute& GetAttribute(const LDOMBasicString& aName,
                                                          const LDOM_BasicNode*  aLastCh) const;
  //    Search for attribute name, using or setting myFirstAttribute

protected:
  // ---------- PROTECTED METHODS ----------

  //  LDOM_BasicElement (const LDOM_Element& anElement);
  //    Constructor

  Standard_EXPORT const LDOM_BasicNode* AddAttribute(const LDOMBasicString& anAttrName,
                                                     const LDOMBasicString& anAttrValue,
                                                     const occ::handle<LDOM_MemManager>& aDoc,
                                                     const LDOM_BasicNode*               aLastCh);
  //    add or replace an attribute to the element

  Standard_EXPORT const LDOM_BasicNode* RemoveAttribute(const LDOMBasicString& aName,
                                                        const LDOM_BasicNode*  aLastCh) const;

  Standard_EXPORT void RemoveChild(const LDOM_BasicNode* aChild) const;
  //    remove a child element

  Standard_EXPORT void AppendChild(const LDOM_BasicNode*  aChild,
                                   const LDOM_BasicNode*& aLastCh) const;
  //    append a child node to the end of the list

private:
  friend class LDOMParser;
  friend class LDOM_XmlReader;
  friend class LDOM_Document;
  friend class LDOM_Element;
  friend class LDOM_Node;
  // ---------- PRIVATE METHODS ----------

  const LDOM_BasicAttribute* GetFirstAttribute(const LDOM_BasicNode*&  aLastCh,
                                               const LDOM_BasicNode**& thePrN) const;

  void RemoveNodes();

  void ReplaceElement(const LDOM_BasicElement& anOther, const occ::handle<LDOM_MemManager>& aDoc);
  //    remark: recursive

  void AddElementsByTagName(LDOM_NodeList& aList, const LDOMBasicString& aTagName) const;
  //    remark: recursive

  void AddAttributes(LDOM_NodeList& aList, const LDOM_BasicNode* aLastCh) const;
  //    add attributes to list

private:
  // ---------- PRIVATE FIELDS ----------

  //  LDOMBasicString       myTagName;
  const char*     myTagName;
  unsigned long   myAttributeMask;
  LDOM_BasicNode* myFirstChild;
};

#endif