propertiesparser.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2007 Tommi Maekitalo
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * As a special exception, you may use this file as part of a free
10  * software library without restriction. Specifically, if other files
11  * instantiate templates or use macros or inline functions from this
12  * file, or you compile this file and link it with other files to
13  * produce an executable, this file does not by itself cause the
14  * resulting executable to be covered by the GNU General Public
15  * License. This exception does not however invalidate any other
16  * reasons why the executable file might be covered by the GNU Library
17  * General Public License.
18  *
19  * This library is distributed in the hope that it will be useful,
20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22  * Lesser General Public License for more details.
23  *
24  * You should have received a copy of the GNU Lesser General Public
25  * License along with this library; if not, write to the Free Software
26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27  */
28 
29 #ifndef CXXTOOLS_PROPERTIESPARSER_H
30 #define CXXTOOLS_PROPERTIESPARSER_H
31 
32 #include <string>
33 #include <cxxtools/char.h>
34 #include <cxxtools/string.h>
35 #include <cxxtools/textstream.h>
37 
38 namespace cxxtools
39 {
41  {
42  public:
43  class Event
44  {
45  public:
46  virtual ~Event() { }
47  // return true, if parser should stop
48  virtual bool onKeyPart(const String& key) = 0;
49  virtual bool onKey(const String& key) = 0;
50  virtual bool onValue(const String& value) = 0;
51  };
52 
53  private:
54  Event& _event;
55  String _key;
56  String _keypart;
57  String _value;
58  String _space;
59  Char::value_type _unicode;
60  unsigned _unicodeCount;
61  unsigned _lineNo;
62  bool _trim;
63 
64  enum {
65  state_0,
66  state_key,
67  state_key_esc,
68  state_key_unicode,
69  state_key_sp,
70  state_value0,
71  state_value,
72  state_value_esc,
73  state_value_cont,
74  state_value_space,
75  state_unicode,
76  state_comment
77  } _state;
78 
79  public:
80  PropertiesParser(Event& event_, bool trim_ = false)
81  : _event(event_),
82  _lineNo(1),
83  _trim(trim_),
84  _state(state_0)
85  { }
86 
87  bool trim() const { return _trim; }
88  void trim(bool sw) { _trim = sw; }
89  void parse(std::basic_istream<Char>& in);
90  void parse(std::istream& in, TextCodec<Char, char>* codec = 0);
91  bool advance(Char ch);
92  void end();
93  };
94 
96  {
97  public:
98  explicit PropertiesParserError(const std::string& msg)
99  : SerializationError(msg)
100  { }
101  PropertiesParserError(const std::string& msg, unsigned lineNo);
102  };
103 }
104 
105 #endif // CXXTOOLS_PROPERTIESPARSER_H