namespace Msp {
/**
-Thrown for errors in lexical conversions
+Thrown for errors in lexical conversions.
*/
class lexical_error: public std::runtime_error
{
};
+/**
+Thrown when the format is unsuitable for the type being converted.
+*/
class format_mismatch: public lexical_error
{
public:
{
private:
Fmt fmt;
+ bool filled;
std::string buf;
public:
- LexicalConverter(const Fmt &f): fmt(f) { }
- LexicalConverter(const std::string &s, const Fmt &f): fmt(f), buf(s) { }
+ LexicalConverter(const Fmt &f): fmt(f), filled(false) { }
+ LexicalConverter(const std::string &s, const Fmt &f): fmt(f), filled(true), buf(s) { }
const Fmt &get_fmt() const { return fmt; }
- const std::string &get() const { return buf; }
+ const std::string &get() const;
void result(const std::string &);
};
throw lexical_error("conversion failure");
}
-// Helper struct to provide partial template specialization
-
+/**
+Helper struct to provide partial template specialization.
+*/
template<typename T, typename F>
struct LexicalCast;
}
};
-// The main interface to the lexical conversion machinery
-
+/** Perform a lexical conversion between a string and another type. The source
+type can normally be deduced by the compiler, so this can be used just like the
+standard C++ casts. A format may additionally be specified to force a specific
+interpretation. */
template<typename T, typename F>
inline T lexical_cast(const F &v, const Fmt &f = Fmt())
{