diff options
author | Dan Goodliffe <dan@randomdan.homeip.net> | 2016-12-30 18:33:55 +0000 |
---|---|---|
committer | Dan Goodliffe <dan@randomdan.homeip.net> | 2016-12-30 18:33:55 +0000 |
commit | 3548df4f8c8b953190f0f1941fc315e54c8a031e (patch) | |
tree | 8270b98ecd9cca7b28e0ec6fbd06211af9072872 | |
parent | Add doxygen comments for compile time formatter (diff) | |
download | libadhocutil-3548df4f8c8b953190f0f1941fc315e54c8a031e.tar.bz2 libadhocutil-3548df4f8c8b953190f0f1941fc315e54c8a031e.tar.xz libadhocutil-3548df4f8c8b953190f0f1941fc315e54c8a031e.zip |
Add missing doxygen comments for Uri
-rw-r--r-- | libadhocutil/uriParse.h | 21 |
1 files changed, 20 insertions, 1 deletions
diff --git a/libadhocutil/uriParse.h b/libadhocutil/uriParse.h index dea44a2..0fa378a 100644 --- a/libadhocutil/uriParse.h +++ b/libadhocutil/uriParse.h @@ -9,27 +9,46 @@ #include <map> namespace AdHoc { + /** + * Class representing a broken down URI. + */ class DLL_PUBLIC Uri { public: - Uri(const std::string &); + /// Constructor accepting a URI to parse. + /// @param uri the URI to parse. + Uri(const std::string & uri); + /// The scheme. std::string scheme; + /// The optional username. boost::optional<std::string> username; + /// The optional password. boost::optional<std::string> password; + /// The host. std::string host; + /// The optional port. boost::optional<uint16_t> port; + /// The optional path. boost::optional<boost::filesystem::path> path; + /// The parsed components of the query string. std::multimap<std::string, std::string> query; + /// The optional fragment. boost::optional<std::string> fragment; }; + /** + * Exception representing a failure attempting to parse a URI. + */ class DLL_PUBLIC InvalidUri : public Exception<std::invalid_argument> { public: + /// Constructor accepting what went wrong and the URI being parsed. InvalidUri(const std::string & err, const std::string & uri); std::string message() const throw() override; + /// The parse error. const std::string err; + /// The URI being parsed when the error occurred. const std::string uri; }; } |