Blinker

1) /* Blinker

2)    Copyright 2011-2014 Stefan Schuermans <stefan@blinkenarea.org>

3)    Copyleft GNU public license - http://www.gnu.org/copyleft/gpl.html
4)    a blinkenarea.org project */
5) 

6) #ifndef BLINKER_STRINGPARSER_H
7) #define BLINKER_STRINGPARSER_H

8) 
9) #include <string>
10) 
11) namespace Blinker {
12) 
13) /// a simple string parser
14) class StringParser
15) {
16) public:
17)   /**
18)    * @brief constructor
19)    * @param[in] str string to parse
20)    */
21)   StringParser(const std::string &str);
22) 
23) public:
24)   /**
25)    * @brief parse fixed character
26)    * @param[in] chr character to expect
27)    * @return if expected character was found and processed
28)    */
29)   bool fixChr(char chr);
30) 

31)   /**

32)    * @brief parse one character out of a set

33)    * @param[in] set set of characters allowed
34)    * @param[out] chr character parsed
35)    * @return if a character from the set was found and processed
36)    */
37)   bool oneChrOf(const std::string &set, char &chr);
38) 

39)   /**
40)    * @brief parse boolean value
41)    * @param[out] boolVal boolean value parsed from string
42)    * @return if parsing was successful
43)    */
44)   bool boolVal(bool &boolVal);
45) 

46)   /**
47)    * @brief parse unsigned number
48)    * @param[out] uint number parsed from string
49)    * @return if parsing was successful
50)    */
51)   bool uintNo(unsigned int &uint);
52) 

53)   /**
54)    * @brief parse unsigned number and check minimum
55)    * @param[in] min minimum value to expect
56)    * @param[out] uint number parsed from string
57)    * @return if parsing was successful
58)    */
59)   bool uintMin(unsigned int min, unsigned int &uint);
60) 

61)   /**
62)    * @brief parse signed number
63)    * @param[out] sint number parsed from string
64)    * @return if parsing was successful
65)    */
66)   bool sintNo(int &sint);
67) 

68)   /**
69)    * @brief parse floating point value
70)    * @param[out] fl floating point value parsed from string
71)    * @return if parsing was successful
72)    */
73)   bool floatVal(float &fl);
74) 

75)   /**
76)    * @brief parse until a delimiter is found
77)    * @param[in] delim set of delimiter characters
78)    * @param[in] empty if empty substring is okay
79)    * @param[out] str substring parsed
80)    * @return if a substring was found and processed
81)    */
82)   bool untilDelim(const std::string &delim, bool empty, std::string &str);
83) 

84)   /**
85)    * @brief check if parsing is done
86)    * @return if parsing is done (i.e. has arrived at the end of the string)
87)    */
88)   bool isDone();
89) 
90) protected:
91)   std::string                 m_str; ///< string begin parsed
92)   std::string::const_iterator m_it;  ///< current position of parsing
93) }; // class StringParser
94) 
95) } // namespace Blinker
96) 

97) #endif // #ifndef BLINKER_STRINGPARSER_H