From 3548df4f8c8b953190f0f1941fc315e54c8a031e Mon Sep 17 00:00:00 2001 From: Dan Goodliffe Date: Fri, 30 Dec 2016 18:33:55 +0000 Subject: Add missing doxygen comments for Uri --- libadhocutil/uriParse.h | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) 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 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 username; + /// The optional password. boost::optional password; + /// The host. std::string host; + /// The optional port. boost::optional port; + /// The optional path. boost::optional path; + /// The parsed components of the query string. std::multimap query; + /// The optional fragment. boost::optional fragment; }; + /** + * Exception representing a failure attempting to parse a URI. + */ class DLL_PUBLIC InvalidUri : public Exception { 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; }; } -- cgit v1.2.3