xpcom/string/nsTDependentString.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   3 /* This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7
   8 /**
   9  * nsTDependentString_CharT
  10  *
  11  * Stores a null-terminated, immutable sequence of characters.
  12  *
  13  * Subclass of nsTString that restricts string value to an immutable
  14  * character sequence.  This class does not own its data, so the creator
  15  * of objects of this type must take care to ensure that a
  16  * nsTDependentString continues to reference valid memory for the
  17  * duration of its use.
  18  */
  19 class nsTDependentString_CharT : public nsTString_CharT
  20 {
  21 public:
  22
  23   typedef nsTDependentString_CharT self_type;
  24
  25 public:
  26
  27   /**
  28    * constructors
  29    */
  30
  31   nsTDependentString_CharT(const char_type* aStart, const char_type* aEnd)
  32     : string_type(const_cast<char_type*>(aStart),
  33                   uint32_t(aEnd - aStart), F_TERMINATED)
  34   {
  35     AssertValidDepedentString();
  36   }
  37
  38   nsTDependentString_CharT(const char_type* aData, uint32_t aLength)
  39     : string_type(const_cast<char_type*>(aData), aLength, F_TERMINATED)
  40   {
  41     AssertValidDepedentString();
  42   }
  43
  44 #if defined(CharT_is_PRUnichar) && defined(MOZ_USE_CHAR16_WRAPPER)
  45   nsTDependentString_CharT(char16ptr_t aData, uint32_t aLength)
  46     : nsTDependentString_CharT(static_cast<const char16_t*>(aData), aLength)
  47   {
  48   }
  49 #endif
  50
  51   explicit
  52   nsTDependentString_CharT(const char_type* aData)
  53     : string_type(const_cast<char_type*>(aData),
  54                   uint32_t(char_traits::length(aData)), F_TERMINATED)
  55   {
  56     AssertValidDepedentString();
  57   }
  58
  59 #if defined(CharT_is_PRUnichar) && defined(MOZ_USE_CHAR16_WRAPPER)
  60   explicit
  61   nsTDependentString_CharT(char16ptr_t aData)
  62     : nsTDependentString_CharT(static_cast<const char16_t*>(aData))
  63   {
  64   }
  65 #endif
  66
  67   nsTDependentString_CharT(const string_type& aStr, uint32_t aStartPos)
  68     : string_type()
  69   {
  70     Rebind(aStr, aStartPos);
  71   }
  72
  73   // Create a nsTDependentSubstring to be bound later
  74   nsTDependentString_CharT()
  75     : string_type()
  76   {
  77   }
  78
  79   // XXX are you sure??
  80   // auto-generated copy-constructor OK
  81   // auto-generated copy-assignment operator OK
  82   // auto-generated destructor OK
  83
  84
  85   /**
  86    * allow this class to be bound to a different string...
  87    */
  88
  89   using nsTString_CharT::Rebind;
  90   void Rebind(const char_type* aData)
  91   {
  92     Rebind(aData, uint32_t(char_traits::length(aData)));
  93   }
  94
  95   void Rebind(const char_type* aStart, const char_type* aEnd)
  96   {
  97     Rebind(aStart, uint32_t(aEnd - aStart));
  98   }
  99
 100   void Rebind(const string_type&, uint32_t aStartPos);
 101
 102 private:
 103
 104   // NOT USED
 105   nsTDependentString_CharT(const substring_tuple_type&) MOZ_DELETE;
 106 };