X-Git-Url: http://git.tdb.fi/?p=libs%2Fcore.git;a=blobdiff_plain;f=source%2Fstrings%2Fformat.h;h=65d10dffa585bb6e272db7d1d20a71a07b6a0a42;hp=9264b10bad1ec2b2f951065d3ee1562d8f033d27;hb=42ff7c629b2aa7411963bdcc2259a06b1d1de6d3;hpb=967785734be5c3fc6f75da122c2d93ebbb338271

diff --git a/source/strings/format.h b/source/strings/format.h
index 9264b10..65d10df 100644
--- a/source/strings/format.h
+++ b/source/strings/format.h
@@ -24,14 +24,23 @@ public:
 	template<typename T>
 	Formatter &operator()(const T &a)
 	{
-		result += lexical_cast(a, get_conversion());
+		result += lexical_cast<std::string>(a, get_conversion());
 		advance();
 		return *this;
 	}
 
+	/** Returns the result of the formatting operation.  Will throw if not
+	enough values have been fed to the formatter. */
 	const std::string &str() const;
+
 private:
+	/** Advances the iterator to the next conversion, adding literal characters
+	to the result.  The iterator is left at the second character of the
+	conversion (i.e. after the %). */
 	void advance();
+
+	/** Reads the next conversion from the format string and returns a
+	corresponding Fmt object. */
 	Fmt get_conversion();
 };