juce/source/src/text/juce_Identifier.h

   1 /*
   2   ==============================================================================
   3
   4    This file is part of the JUCE library - "Jules' Utility Class Extensions"
   5    Copyright 2004-11 by Raw Material Software Ltd.
   6
   7   ------------------------------------------------------------------------------
   8
   9    JUCE can be redistributed and/or modified under the terms of the GNU General
  10    Public License (Version 2), as published by the Free Software Foundation.
  11    A copy of the license is included in the JUCE distribution, or can be found
  12    online at www.gnu.org/licenses.
  13
  14    JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
  15    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  16    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  17
  18   ------------------------------------------------------------------------------
  19
  20    To release a closed-source product which uses JUCE, commercial licenses are
  21    available: visit www.rawmaterialsoftware.com/juce for more information.
  22
  23   ==============================================================================
  24 */
  25
  26 #ifndef __JUCE_IDENTIFIER_JUCEHEADER__
  27 #define __JUCE_IDENTIFIER_JUCEHEADER__
  28
  29 class StringPool;
  30
  31
  32 //==============================================================================
  33 /**
  34     Represents a string identifier, designed for accessing properties by name.
  35
  36     Identifier objects are very light and fast to copy, but slower to initialise
  37     from a string, so it's much faster to keep a static identifier object to refer
  38     to frequently-used names, rather than constructing them each time you need it.
  39
  40     @see NamedPropertySet, ValueTree
  41 */
  42 class JUCE_API  Identifier
  43 {
  44 public:
  45     /** Creates a null identifier. */
  46     Identifier() noexcept;
  47
  48     /** Creates an identifier with a specified name.
  49         Because this name may need to be used in contexts such as script variables or XML
  50         tags, it must only contain ascii letters and digits, or the underscore character.
  51     */
  52     Identifier (const char* name);
  53
  54     /** Creates an identifier with a specified name.
  55         Because this name may need to be used in contexts such as script variables or XML
  56         tags, it must only contain ascii letters and digits, or the underscore character.
  57     */
  58     Identifier (const String& name);
  59
  60     /** Creates a copy of another identifier. */
  61     Identifier (const Identifier& other) noexcept;
  62
  63     /** Creates a copy of another identifier. */
  64     Identifier& operator= (const Identifier& other) noexcept;
  65
  66     /** Destructor */
  67     ~Identifier();
  68
  69     /** Compares two identifiers. This is a very fast operation. */
  70     inline bool operator== (const Identifier& other) const noexcept     { return name == other.name; }
  71
  72     /** Compares two identifiers. This is a very fast operation. */
  73     inline bool operator!= (const Identifier& other) const noexcept     { return name != other.name; }
  74
  75     /** Returns this identifier as a string. */
  76     String toString() const                                             { return name; }
  77
  78     /** Returns this identifier's raw string pointer. */
  79     operator const String::CharPointerType() const noexcept             { return name; }
  80
  81     /** Checks a given string for characters that might not be valid in an Identifier.
  82         Since Identifiers are used as a script variables and XML attributes, they should only contain
  83         alphanumeric characters, underscores, or the '-' and ':' characters.
  84     */
  85     static bool isValidIdentifier (const String& possibleIdentifier) noexcept;
  86
  87
  88 private:
  89     //==============================================================================
  90     String::CharPointerType name;
  91
  92     static StringPool& getPool();
  93 };
  94
  95
  96 #endif   // __JUCE_IDENTIFIER_JUCEHEADER__