Blinker

1) /* Blinker
2)    Copyright 2011 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 ot 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 unsigned number
41)    * @param[out] uint number parsed from string
42)    * @return if parsing was successful
43)    */
44)   bool uintNo(unsigned int &uint);
45) 

46)   /**
47)    * @brief parse unsigned number and check minimum
48)    * @param[in] min minimum value to expect
49)    * @param[out] uint number parsed from string
50)    * @return if parsing was successful
51)    */
52)   bool uintMin(unsigned int min, unsigned int &uint);
53) 

54)   /**
55)    * @brief parse signed number
56)    * @param[out] sint number parsed from string
57)    * @return if parsing was successful
58)    */
59)   bool sintNo(int &sint);
60) 

61)   /**
62)    * @brief check if parsing is done
63)    * @return if parsing is done (i.e. has arrived at the end of the string)
64)    */
65)   bool isDone();
66) 
67) protected:
68)   std::string                 m_str; ///< string begin parsed
69)   std::string::const_iterator m_it;  ///< current position of parsing
70) }; // class StringParser
71) 
72) } // namespace Blinker
73) 

74) #endif // #ifndef BLINKER_STRINGPARSER_H