diff options
Diffstat (limited to 'raul')
| -rw-r--r-- | raul/Path.hpp | 6 | ||||
| -rw-r--r-- | raul/Symbol.hpp | 70 |
2 files changed, 74 insertions, 2 deletions
diff --git a/raul/Path.hpp b/raul/Path.hpp index 8cda1fa..092b337 100644 --- a/raul/Path.hpp +++ b/raul/Path.hpp @@ -24,6 +24,8 @@ #include <cstring> #include <cassert> +#include <raul/Symbol.hpp> + namespace Raul { @@ -44,7 +46,7 @@ namespace Raul { class Path : public std::basic_string<char> { public: - /** Contrust an uninitialzed path, because the STL is annoying. */ + /** Construct an uninitialzed path, because the STL is annoying. */ Path() : std::basic_string<char>("/") {} /** Construct a Path from an std::string. @@ -88,7 +90,7 @@ public: /** Return the name of this object (everything after the last '/'). * This is the "method name" for OSC paths. */ - inline std::basic_string<char> name() const { + inline Symbol name() const { if ((*this) == "/") return ""; else diff --git a/raul/Symbol.hpp b/raul/Symbol.hpp new file mode 100644 index 0000000..0b8cba7 --- /dev/null +++ b/raul/Symbol.hpp @@ -0,0 +1,70 @@ +/* This file is part of Raul. + * Copyright (C) 2008 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_SYMBOL_HPP +#define RAUL_SYMBOL_HPP + +#include <iostream> +#include <cctype> +#include <string> +#include <cstring> +#include <cassert> + +namespace Raul { + + +/** A restricted string (C identifier, which is a component of a path). + * + * A Symbol is an lv2-compliant symbol, which is also valid as a component of + * a URI, filesystem or OSC path, programming language identifier, etc. + * \ingroup raul + */ +class Symbol : public std::basic_string<char> { +public: + + /** Construct a Symbol from an std::string. + * + * It is a fatal error to construct a Symbol from an invalid string, + * use is_valid first to check. + */ + Symbol(const std::basic_string<char>& symbol) + : std::basic_string<char>(symbol) + { + assert(is_valid(symbol)); + } + + + /** Construct a Symbol from a C string. + * + * It is a fatal error to construct a Symbol from an invalid string, + * use is_valid first to check. + */ + Symbol(const char* csymbol) + : std::basic_string<char>(csymbol) + { + assert(is_valid(csymbol)); + } + + static bool is_valid(const std::basic_string<char>& path); + + static std::string symbolify(const std::basic_string<char>& str); +}; + + +} // namespace Raul + +#endif // RAUL_SYMBOL_HPP |