/* -*- Mode: C++; c-default-style: "k&r"; indent-tabs-mode: nil; tab-width: 2; c-basic-offset: 2 -*- */

/* libmwaw

* Version: MPL 2.0 / LGPLv2+

*

* The contents of this file are subject to the Mozilla Public License Version

* 2.0 (the "License"); you may not use this file except in compliance with

* the License or as specified alternatively below. You may obtain a copy of

* the License at http://www.mozilla.org/MPL/

*

* Software distributed under the License is distributed on an "AS IS" basis,

* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License

* for the specific language governing rights and limitations under the

* License.

*

* Major Contributor(s):

* Copyright (C) 2002 William Lachance (wrlach@gmail.com)

* Copyright (C) 2002,2004 Marc Maurer (uwog@uwog.net)

* Copyright (C) 2004-2006 Fridrich Strba (fridrich.strba@bluewin.ch)

* Copyright (C) 2006, 2007 Andrew Ziem

* Copyright (C) 2011, 2012 Alonso Laurent (alonso@loria.fr)

*

*

* All Rights Reserved.

*

* For minor contributions see the git repository.

*

* Alternatively, the contents of this file may be used under the terms of

* the GNU Lesser General Public License Version 2 or later (the "LGPLv2+"),

* in which case the provisions of the LGPLv2+ are applicable

* instead of those above.

*/

#ifndef MWAW_PROPERTY_HANDLER

#  define MWAW_PROPERTY_HANDLER

#  include <ostream>

#  include <sstream>

#  include <string>

#  include <librevenge/librevenge.h>

//! a generic property handler

class MWAWPropertyHandler

{

public:

  //! constructor

  MWAWPropertyHandler()

  {

  }

  //! destructor

  virtual ~MWAWPropertyHandler();

  //! inserts a simple element

  virtual void insertElement(const char *psName) = 0;

  //! inserts an element ( given a property list )

  virtual void insertElement(const char *psName, const librevenge::RVNGPropertyList &xPropList) = 0;

  //! writes a list of characters

  virtual void characters(librevenge::RVNGString const &sCharacters) = 0;

  //! checks a encoded librevenge::RVNGBinaryData created by MWAWPropertyHandlerEncoder

  bool checkData(librevenge::RVNGBinaryData const &encoded);

  //! reads a encoded librevenge::RVNGBinaryData created by MWAWPropertyHandlerEncoder

  bool readData(librevenge::RVNGBinaryData const &encoded);

};

/*! \brief write in librevenge::RVNGBinaryData a list of tags/and properties

 *

 * In order to be read by writerperfect, we must code document consisting in

 * tag and propertyList in an intermediar format:

 *  - [string:s]: an int length(s) follow by the length(s) characters of string s

 *  - [property:p]: a string value p.getStr() ( for a basic property )

 *  - [propertyList:pList]: a int: \#pList followed by

 *      -+ 'p',pList[i].key(),pList[i] for a basic child

 *      -+ 'v',pList[i].key(),*(pList.child(pList[i].key())) for a vector child

 *  - [propertyListVector:v]: a int: \#v followed by v[0], v[1], ...

 *  - [binaryData:d]: a int32 d.size() followed by the data content

 *

 *  - [insertElement:name]: char 'E', [string] name

 *  - [insertElement:name proplist:prop]: char 'S', [string] name, prop

 *  - [characters:s ]: char 'T', [string] s

 *            - if len(s)==0, we write nothing

 *            - the string is written as is (ie. we do not escaped any characters).

*/

class MWAWPropertyHandlerEncoder

{

public:

  //! constructor

  MWAWPropertyHandlerEncoder();

  //! inserts an element

  void insertElement(const char *psName);

  //! inserts an element given a property list

  void insertElement(const char *psName, const librevenge::RVNGPropertyList &xPropList);

  //! writes a list of characters

  void characters(librevenge::RVNGString const &sCharacters);

  //! retrieves the data

  bool getData(librevenge::RVNGBinaryData &data);

protected:

  //! adds a long value if f

  void writeLong(long val);

  //! adds a string: size and string

  void writeString(const librevenge::RVNGString &name);

  //! adds a property: a string key, a string corresponding to value

  void writeProperty(const char *key, const librevenge::RVNGProperty &prop);

  //! adds a property list: int \#prop followed by the different properties

  void writePropertyList(const librevenge::RVNGPropertyList &prop);

  //! adds a property vector: a int: \#vect followed by vect[0], vect[1], ...

  void writePropertyListVector(const librevenge::RVNGPropertyListVector &vect);

  //! the streamfile

  std::stringstream m_f;

};

#endif

// vim: set filetype=cpp tabstop=2 shiftwidth=2 cindent autoindent smartindent noexpandtab: