summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Goodliffe <dan@randomdan.homeip.net>2016-12-30 18:33:55 +0000
committerDan Goodliffe <dan@randomdan.homeip.net>2016-12-30 18:33:55 +0000
commit3548df4f8c8b953190f0f1941fc315e54c8a031e (patch)
tree8270b98ecd9cca7b28e0ec6fbd06211af9072872
parentAdd doxygen comments for compile time formatter (diff)
downloadlibadhocutil-3548df4f8c8b953190f0f1941fc315e54c8a031e.tar.bz2
libadhocutil-3548df4f8c8b953190f0f1941fc315e54c8a031e.tar.xz
libadhocutil-3548df4f8c8b953190f0f1941fc315e54c8a031e.zip
Add missing doxygen comments for Uri
-rw-r--r--libadhocutil/uriParse.h21
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;
};
}