/usr/include/raul/Symbol.hpp is in libraul-dev 0.8.0+dfsg0-0.1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | /* This file is part of Raul.
* Copyright (C) 2008-2009 David 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 <cassert>
#include <cctype>
#include <cstring>
#include <iostream>
#include <string>
#include <glib.h>
namespace Raul {
/** A restricted string (C identifier, which is a component of a Path).
*
* A Symbol is a very restricted string suitable for use as an identifier.
* It is a valid LV2 symbol, URI fragment, filename, OSC path fragment,
* and identifier for most programming languages (including C).
*
* Valid characters are _, a-z, A-Z, 0-9, except the first character which
* must not be 0-9.
*
* \ingroup raul
*/
class Symbol {
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)
: _str(g_intern_string(symbol.c_str()))
{
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)
: _str(g_intern_string(csymbol))
{
assert(is_valid(csymbol));
}
inline const char* c_str() const { return _str; }
inline bool operator==(const Symbol& other) const {
return _str == other._str;
}
inline bool operator!=(const Symbol& other) const {
return _str != other._str;
}
inline bool operator<(const Symbol& other) const {
return strcmp(_str, other._str) < 0;
}
static bool is_valid(const std::basic_string<char>& symbol);
static std::string symbolify(const std::basic_string<char>& str);
private:
const char* _str;
};
} // namespace Raul
static inline std::ostream& operator<<(std::ostream& os, const Raul::Symbol& symbol)
{
return (os << symbol.c_str());
}
#endif // RAUL_SYMBOL_HPP
|