The great ID refactoring of 2009.

Path is now actually URI (scheme path: for now).
Therefore ingen nodes and such live in the same namespace as ... well, everything.
Including plugins.
Thar be profit, laddies.


git-svn-id: http://svn.drobilla.net/lad/trunk/raul@1992 a436a847-0d15-0410-975c-d299462d15a1

1 files changed, 111 insertions, 0 deletions

diff --git a/raul/URI.hpp b/raul/URI.hpp
new file mode 100644
index 0000000..5967609
--- /dev/null
+++ b/raul/URI.hpp
@@ -0,0 +1,111 @@
+/* This file is part of Raul.
+ * Copyright (C) 2007 Dave Robillard <http://drobilla.net>
+ * 
+ * Raul is free software; you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation; either version 2 of the License, or (at your option) any later
+ * version.
+ * 
+ * Raul is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+
+#ifndef RAUL_URI_HPP
+#define RAUL_URI_HPP
+
+#include <string>
+#include <exception>
+#include <ostream>
+
+namespace Raul {
+
+	
+/** Simple wrapper around standard string with useful URI-specific methods.
+ *
+ * This "should" be used for proper URIs (RFC3986), but not much support or
+ * validation is built-in yet.  The URI string MUST have a scheme though.
+ */
+class URI : protected std::basic_string<char> {
+public:
+	class BadURI : public std::exception {
+	public:
+		BadURI(const std::string& uri) : _uri(uri) {}
+		~BadURI() throw() {}
+		const char* what() const throw() { return _uri.c_str(); }
+	private:
+		std::string _uri;
+	};
+
+	/** Construct a URI from an std::string.
+	 *
+	 * It is a fatal error to construct a URI from an invalid string,
+	 * use is_valid first to check.
+	 */
+	URI(const std::basic_string<char>& uri) : std::basic_string<char>(uri) {
+		if (!is_valid(uri))
+			throw BadURI(uri);
+	}
+
+	/** Construct a URI from a C string.
+	 *
+	 * It is a fatal error to construct a URI from an invalid string,
+	 * use is_valid first to check.
+	 */
+	URI(const char* uri) : std::basic_string<char>(uri) {
+		if (!is_valid(uri))
+			throw BadURI(uri);
+	}
+
+	static bool is_valid(const std::basic_string<char>& uri) {
+		return uri.find(":") != std::string::npos;
+	}
+	
+	/** Return path with every up to and including the first occurence of str */
+	inline const std::string chop_start(const std::string& str) const {
+		return substr(find(str) + str.length());
+	}
+
+	/** Return the URI with the scheme removed (as a string) */
+	std::string chop_scheme() const { return chop_start(":"); }
+
+	/** Return the URI scheme (everything before the first ':') */
+	inline std::string name() const { return substr(0, find(":")); }
+
+	inline const std::string& str()   const { return *this; }
+	inline const char*        c_str() const { return str().c_str(); }
+
+	inline operator const std::string() const { return str(); }
+	inline operator       std::string()       { return str(); }
+	
+	inline std::string substr(size_t start, size_t end=std::string::npos) const {
+		return str().substr(start, end);
+	}
+
+	inline bool operator<(const URI& uri)  const { return str() <  uri; }
+	inline bool operator<=(const URI& uri) const { return str() <= uri; }
+	inline bool operator>(const URI& uri)  const { return str() >  uri; }
+	inline bool operator>=(const URI& uri) const { return str() >= uri; }
+	inline bool operator==(const URI& uri) const { return str() == uri; }
+	inline bool operator!=(const URI& uri) const { return str() != uri; }
+
+	inline size_t length()                           const { return str().length(); }
+	inline size_t find(const std::string& s)         const { return str().find(s); }
+	inline size_t find_last_of(const std::string& s) const { return str().find_last_of(s); }
+};
+
+static inline
+std::ostream&
+operator<<(std::ostream& os, const URI& uri)
+{
+	return (os << uri.str());
+}
+
+} // namespace Raul
+
+#endif // RAUL_URI_HPP
+