WebCore/khtml/dom/dom_string.h

   1 /*
   2  * This file is part of the DOM implementation for KDE.
   3  *
   4  * (C) 1999 Lars Knoll (knoll@kde.org)
   5  * Copyright (C) 2004 Apple Computer, Inc.
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Library General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Library General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Library General Public License
  18  * along with this library; see the file COPYING.LIB.  If not, write to
  19  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  *
  22  */
  23 #ifndef _DOM_DOMString_h_
  24 #define _DOM_DOMString_h_
  25
  26 #include <qstring.h>
  27 #include <xml/dom_stringimpl.h>
  28
  29 namespace khtml {
  30     class Length;
  31 }
  32
  33 namespace DOM {
  34
  35 class DOMStringImpl;
  36
  37 /**
  38  * This class implements the basic string we use in the DOM. We do not use
  39  * QString for 2 reasons: Memory overhead, and the missing explicit sharing
  40  * of strings we need for the DOM.
  41  *
  42  * All DOMStrings are explicitly shared (they behave like pointers), meaning
  43  * that modifications to one instance will also modify all others. If you
  44  * wish to get a DOMString that is independent, use @ref copy().
  45  */
  46 class DOMString
  47 {
  48     friend class CharacterDataImpl;
  49     friend bool operator==( const DOMString &a, const char *b );
  50     friend bool operator==( const DOMString &a, const DOMString &b );
  51 public:
  52     /**
  53      * default constructor. Gives an empty DOMString
  54      */
  55     DOMString() : impl(0) { }
  56
  57     DOMString(const QChar *str, uint len);
  58     DOMString(const QString &);
  59     DOMString(const char *str);
  60     DOMString(DOMStringImpl *i);
  61     ~DOMString() { if(impl) impl->deref(); }
  62
  63
  64     // assign and copy
  65     DOMString(const DOMString &str);
  66     DOMString &operator =(const DOMString &str);
  67
  68     /**
  69      * append str to this string
  70      */
  71     DOMString &operator += (const DOMString &str);
  72
  73     void insert(DOMString str, uint pos);
  74
  75     /**
  76      * The character at position i of the DOMString. If i >= length(), the
  77      * character returned will be 0.
  78      */
  79     const QChar &operator [](unsigned int i) const;
  80
  81     int find(const QChar c, int start = 0) const;
  82
  83     uint length() const;
  84     void truncate( unsigned int len );
  85     void remove(unsigned int pos, int len=1);
  86     /**
  87      * Splits the string into two. The original string gets truncated to pos, and the rest is returned.
  88      */
  89     DOMString split(unsigned int pos);
  90
  91     /**
  92      * Returns a lowercase version of the string
  93      */
  94     DOMString lower() const;
  95     /**
  96      * Returns an uppercase version of the string
  97      */
  98     DOMString upper() const;
  99
 100     QChar *unicode() const;
 101     QString string() const;
 102
 103     int toInt() const;
 104     khtml::Length* toLengthArray(int& len) const;
 105     bool percentage(int &_percentage) const;
 106
 107     DOMString copy() const;
 108
 109     bool isNull()  const { return (impl == 0); }
 110     bool isEmpty()  const;
 111
 112     /**
 113      * @internal get a handle to the imlementation of the DOMString
 114      * Use at own risk!!!
 115      */
 116     DOMStringImpl *implementation() const { return impl; }
 117
 118 #ifdef __OBJC__
 119     DOMString(NSString *);
 120     operator NSString *() const;
 121 #endif
 122
 123 #ifndef NDEBUG
 124     // For debugging only, leaks memory.
 125     const char *ascii() const;
 126 #endif
 127
 128 protected:
 129     DOMStringImpl *impl;
 130 };
 131
 132 DOMString operator + (const DOMString &a, const DOMString &b);
 133 bool operator==( const DOMString &a, const QString &b );
 134 bool operator==( const DOMString &a, const char *b );
 135 inline bool operator==( const QString &b, const DOMString &a ) { return a == b; }
 136 inline bool operator==( const char *b, const DOMString &a ) { return a == b; }
 137 inline bool operator!=( const DOMString &a, const DOMString &b ) { return !(a==b); }
 138 inline bool operator!=( const DOMString &a, const QString &b ) { return !(a==b); }
 139 inline bool operator!=( const DOMString &a, const char *b )  { return !(a==b); }
 140 inline bool operator!=( const QString &b, const DOMString &a ) { return !(a==b); }
 141 inline bool operator!=( const char *b, const DOMString &a )  { return !(a==b); }
 142 inline bool strcmp( const DOMString &a, const DOMString &b ) { return a != b; }
 143
 144 // returns false when equal, true otherwise (ignoring case)
 145 bool strcasecmp( const DOMString &a, const DOMString &b );
 146 bool strcasecmp( const DOMString& a, const char* b );
 147
 148 };
 149 #endif