kcharsets.h

Go to the documentation of this file.

/* This file is part of the KDE libraries
    Copyright (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 KCHARSETS_H
#define KCHARSETS_H

#include <kdemacros.h>
#include <kdecore_export.h>
#include <QtCore/QList>

class KCharsets;
class KCharsetsPrivate;

class QChar;
class QString;
class QStringList;
class QTextCodec;

namespace KGlobal
{
    KDECORE_EXPORT KCharsets *charsets();
}

class KDECORE_EXPORT KCharsets
{
    friend KCharsets *KGlobal::charsets();

protected:
    KCharsets();

public:

    virtual ~KCharsets();

    QTextCodec *codecForName(const QString &name) const;

    QTextCodec *codecForName(const QString &n, bool &ok) const;

    static QChar fromEntity(const QString &str);

    static QChar fromEntity(const QString &str, int &len);

    static QString toEntity(const QChar &ch);

    static QString resolveEntities( const QString &text );

    QStringList availableEncodingNames() const;

    QStringList descriptiveEncodingNames() const;

    QList<QStringList> encodingsByScript() const;

#ifndef KDE_NO_DEPRECATED
    KDE_DEPRECATED QString languageForEncoding( const QString &encoding ) const;
#endif

    QString descriptionForEncoding( const QString& encoding ) const;

    QString encodingForName( const QString &descriptiveName ) const;

private:
    KCharsetsPrivate* const d;

    QTextCodec *codecForNameOrNull( const QByteArray& n ) const;
};

#endif