You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdelibs/khtml/dom/dom_string.h

145 lines
4.2 KiB

/*
* This file is part of the DOM implementation for KDE.
*
* (C) 1999 Lars Knoll (knoll@kde.org)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
*/
#ifndef _DOM_DOMString_h_
#define _DOM_DOMString_h_
#include <kdebug.h>
#include <qstring.h>
#include <kdelibs_export.h>
namespace DOM {
class DOMStringImpl;
/**
* This class implements the basic string we use in the DOM. We do not use
* QString for 2 reasons: Memory overhead, and the missing explicit sharing
* of strings we need for the DOM.
*
* All DOMStrings are explicitly shared (they behave like pointers), meaning
* that modifications to one instance will also modify all others. If you
* wish to get a DOMString that is independent, use copy().
*/
class KHTML_EXPORT DOMString
{
friend class CharacterDataImpl;
friend KHTML_EXPORT bool operator==( const DOMString &a, const char *b );
public:
/**
* default constructor. Gives an empty DOMString
*/
DOMString() : impl(0) {}
DOMString(const QChar *str, uint len);
DOMString(const QString &);
DOMString(const char *str);
DOMString(DOMStringImpl *i);
virtual ~DOMString();
// assign and copy
DOMString(const DOMString &str);
DOMString &operator =(const DOMString &str);
/**
* append str to this string
*/
DOMString &operator += (const DOMString &str);
/**
* add two DOMString's
*/
DOMString operator + (const DOMString &str);
void insert(DOMString str, uint pos);
/**
* The character at position i of the DOMString. If i >= length(), the
* character returned will be 0.
*/
const QChar &operator [](unsigned int i) const;
int find(const QChar c, int start = 0) const;
uint length() const;
void truncate( unsigned int len );
void remove(unsigned int pos, int len=1);
/**
* Splits the string into two. The original string gets truncated to pos, and the rest is returned.
*/
DOMString split(unsigned int pos);
/**
* Returns a lowercase version of the string
*/
DOMString lower() const;
/**
* Returns an uppercase version of the string
*/
DOMString upper() const;
QChar *unicode() const;
QString string() const;
int toInt() const;
bool percentage(int &_percentage) const;
DOMString copy() const;
bool isNull() const { return (impl == 0); }
bool isEmpty() const;
/**
* @internal get a handle to the imlementation of the DOMString
* Use at own risk!!!
*/
DOMStringImpl *implementation() const { return impl; }
protected:
DOMStringImpl *impl;
};
#ifndef NDEBUG
inline kdbgstream &operator<<(kdbgstream &stream, const DOMString &string) {
return (stream << string.string());
}
#else
inline kndbgstream &operator<<(kndbgstream &stream, const DOMString &) {
return stream;
}
#endif
KHTML_EXPORT bool operator==( const DOMString &a, const DOMString &b );
KHTML_EXPORT bool operator==( const DOMString &a, const QString &b );
KHTML_EXPORT bool operator==( const DOMString &a, const char *b );
inline bool operator!=( const DOMString &a, const DOMString &b ) { return !(a==b); }
inline bool operator!=( const DOMString &a, const QString &b ) { return !(a==b); }
inline bool operator!=( const DOMString &a, const char *b ) { return !(a==b); }
inline bool strcmp( const DOMString &a, const DOMString &b ) { return a != b; }
// returns false when equal, true otherwise (ignoring case)
KHTML_EXPORT bool strcasecmp( const DOMString &a, const DOMString &b );
KHTML_EXPORT bool strcasecmp( const DOMString& a, const char* b );
}
#endif