/home/matthew/data/programming/current/libircpp/parser.h

/* 
 * libircpp++ parser.h
 */
#ifndef __PARSER_H__
#define __PARSER_H__

#include <string>
#include <boost/signal.hpp>
#include "entity.h"
#include "user.h"
#include "channel.h"
#include "message.h"

/* Note about sig_message:
 *
 * The slot group ordering on sig_message is critical to the integrity of the various
 * user and channel lists. The ordering should be as follows:
 *
 * (first)
 * 20 - mainuserlist::pre_names_slot
 * 30 - channeluserlist::pre_message_slot (pre_names & pre_leave signals)
 * 40 - session::message_sorter (emits user-facing signals)
 * 50 - channellist::post_leave_slot
 * 60 - channeluserlist::post_leave_slot
 * 70 - mainuserlist::post_quit_slot
 * (last)
 */ 

namespace ircpp {

        class session;
        class message;

        class parser 
        {
                /* Interface functions */
                public:
                        /* Constructors and destructors */
                        explicit parser(session& parent);
                        ~parser();

                        /* Data functions */
                        bool supply_buffer(const std::string &data);

                        /* Signals */
                        boost::signal1<void, message&> sig_message; /* Main message signal - emitted for every message parsed */
                        boost::signal1<void, message&> sig_singlemode; /* A "fake" mode message emitted for each mode letter received */
                        boost::signal1<void, const std::string&> sig_parseerror; /* Emitted upon parse error. Contains offending string */

                        /* Internal signals - used for updating objects */
                        boost::signal2<void, const std::string&, const std::string&> sig_pre_join; /* emitted just before a user joins a channel */
                        boost::signal1<void, message&> sig_pre_names; /* emitted just before a names-reply message is emitted */
                        boost::signal1<void, const message&> sig_update_data; /* emitted when various data available for storage e.g. whois replies */

                /* Private functions */
                private:
                        void parse_lines();
                        void parse_params(message& msg, const size_t params_pos);
                        void parse_modes(const message& msg);
                        void process_message(const std::string& line);
                        void get_next_word(std::istringstream& stream, std::string& into);
                        user* get_user(const std::string& nick, bool add = false);
                        channel* get_channel(const std::string& name);
                        entity* fill(const std::string& name);



                /* Private data */
                private:
                        session& s;
                        std::string buffer;
        };

} /* namespace ircpp */

#endif /* __PARSER_H__ */

---