1 /****************************************************************************

     2 ** 

     3 **

     4 ** Definition of QTextCodec class

     5 **

     6 ** Created : 981015

     7 **

     8 ** Copyright (C) 1998-2000 Trolltech AS.  All rights reserved.

     9 **

    10 ** This file is part of the tools module of the Qt GUI Toolkit.

    11 **

    12 ** This file may be distributed under the terms of the Q Public License

    13 ** as defined by Trolltech AS of Norway and appearing in the file

    14 ** LICENSE.QPL included in the packaging of this file.

    15 **

    16 ** This file may be distributed and/or modified under the terms of the

    17 ** GNU General Public License version 2 as published by the Free Software

    18 ** Foundation and appearing in the file LICENSE.GPL included in the

    19 ** packaging of this file.

    20 **

    21 ** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition

    22 ** licenses may use this file in accordance with the Qt Commercial License

    23 ** Agreement provided with the Software.

    24 **

    25 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE

    26 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

    27 **

    28 ** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for

    29 **   information about Qt Commercial License Agreements.

    30 ** See http://www.trolltech.com/qpl/ for QPL licensing information.

    31 ** See http://www.trolltech.com/gpl/ for GPL licensing information.

    32 **

    33 ** Contact info@trolltech.com if any conditions of this licensing are

    34 ** not clear to you.

    35 **

    36 **********************************************************************/

    37 

    38 #ifndef QTEXTCODEC_H

    39 #define QTEXTCODEC_H

    40 

    41 #ifndef QT_H

    42 #include "qstring.h"

    43 #endif // QT_H

    44 

    45 #ifndef QT_NO_TEXTCODEC

    46 

    47 class QTextCodec;

    48 class QIODevice;

    49 

    50 class Q_EXPORT QTextEncoder {

    51 public:

    52     virtual ~QTextEncoder();

    53     virtual QCString fromUnicode(const QString& uc, int& lenInOut) = 0;

    54 };

    55 

    56 class Q_EXPORT QTextDecoder {

    57 public:

    58     virtual ~QTextDecoder();

    59     virtual QString toUnicode(const char* chars, int len) = 0;

    60 };

    61 

    62 class Q_EXPORT QTextCodec {

    63 public:

    64     virtual ~QTextCodec();

    65 

    66 #ifndef QT_NO_CODECS

    67     static QTextCodec* loadCharmap(QIODevice*);

    68     static QTextCodec* loadCharmapFile(QString filename);

    69 #endif

    70     static QTextCodec* codecForMib(int mib);

    71     static QTextCodec* codecForName(const char* hint, int accuracy=0);

    72     static QTextCodec* codecForContent(const char* chars, int len);

    73     static QTextCodec* codecForIndex(int i);

    74     static QTextCodec* codecForLocale();

    75 

    76     static void deleteAllCodecs();

    77 

    78     static const char* locale();

    79 

    80     virtual const char* name() const = 0;

    81     virtual int mibEnum() const = 0;

    82 

    83     virtual QTextDecoder* makeDecoder() const;

    84     virtual QTextEncoder* makeEncoder() const;

    85 

    86     virtual QString toUnicode(const char* chars, int len) const;

    87     virtual QCString fromUnicode(const QString& uc, int& lenInOut) const;

    88 

    89     QCString fromUnicode(const QString& uc) const;

    90     QString toUnicode(const QByteArray&, int len) const;

    91     QString toUnicode(const QByteArray&) const;

    92     QString toUnicode(const char* chars) const;

    93     virtual bool canEncode( QChar ) const;

    94     virtual bool canEncode( const QString& ) const;

    95 

    96     virtual int heuristicContentMatch(const char* chars, int len) const = 0;

    97     virtual int heuristicNameMatch(const char* hint) const;

    98 

    99 protected:

   100     QTextCodec();

   101     static int simpleHeuristicNameMatch(const char* name, const char* hint);

   102 };

   103 #endif // QT_NO_TEXTCODEC

   104 #endif // QTEXTCODEC_H