X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=include%2Fhashcomp.h;h=1d3a5d0b1d8494ae43fba75a6cbf1757af91f404;hb=a1f073f66f4b985bf776b9be2015136209c0c311;hp=b818b16f532a38277e715ad30766d753a6b22251;hpb=ef10f984fa75c3197ec2515418e1b180fdbfc390;p=user%2Fhenk%2Fcode%2Finspircd.git

diff --git a/include/hashcomp.h b/include/hashcomp.h
index b818b16f5..1d3a5d0b1 100644
--- a/include/hashcomp.h
+++ b/include/hashcomp.h
@@ -79,6 +79,18 @@ namespace irc
 	        bool operator()(const in_addr &s1, const in_addr &s2) const;
 	};
 
+	/** irc::tokenstream reads a string formatted as per RFC1459 and RFC2812.
+	 * It will split the string into 'tokens' each containing one parameter
+	 * from the string.
+	 * For instance, if it is instantiated with the string:
+	 * "PRIVMSG #test :foo bar baz qux"
+	 * then each successive call to tokenstream::GetToken() will return
+	 * "PRIVMSG", "#test", "foo bar baz qux", "".
+	 * Note that if the whole string starts with a colon this is not taken
+	 * to mean the string is all one parameter, and the first item in the
+	 * list will be ":item". This is to allow for parsing 'source' fields
+	 * from data.
+	 */
 	class tokenstream
 	{
 	 private:
@@ -87,9 +99,39 @@ namespace irc
 		std::string::iterator n;
 		bool last_pushed;
 	 public:
-		tokenstream(std::string &source);
+		/** Create a tokenstream and fill it with the provided data
+		 */
+		tokenstream(const std::string &source);
 		~tokenstream();
 
+		/** Fetch the next token from the stream
+		 * @returns The next token is returned, or an empty string if none remain
+		 */
+		const std::string GetToken();
+	};
+
+	/** irc::commasepstream allows for splitting comma seperated lists.
+	 * Lists passed to irc::commasepstream should not contain spaces
+	 * after the commas, or this will be taken to be part of the item
+	 * data. Each successive call to commasepstream::GetToken() returns
+	 * the next token, until none remain, at which point the method returns
+	 * an empty string.
+	 */
+	class commasepstream
+	{
+	 private:
+		std::string tokens;
+		std::string::iterator last_starting_position;
+		std::string::iterator n;
+	 public:
+		/** Create a commasepstream and fill it with the provided data
+		 */
+		commasepstream(const std::string &source);
+		~commasepstream();
+
+		/** Fetch the next token from the stream
+		 * @returns The next token is returned, or an empty string if none remain
+		 */
 		const std::string GetToken();
 	};