qtextcodec.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtCore module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QTEXTCODEC_H
  38. #define QTEXTCODEC_H
  39. #include <QtCore/qstring.h>
  40. #include <QtCore/qlist.h>
  41. QT_BEGIN_HEADER
  42. QT_BEGIN_NAMESPACE
  43. QT_MODULE(Core)
  44. #ifndef QT_NO_TEXTCODEC
  45. class QTextCodec;
  46. class QIODevice;
  47. class QTextDecoder;
  48. class QTextEncoder;
  49. class Q_CORE_EXPORT QTextCodec
  50. {
  51.     Q_DISABLE_COPY(QTextCodec)
  52. public:
  53.     static QTextCodec* codecForName(const QByteArray &name);
  54.     static QTextCodec* codecForName(const char *name) { return codecForName(QByteArray(name)); }
  55.     static QTextCodec* codecForMib(int mib);
  56.     static QList<QByteArray> availableCodecs();
  57.     static QList<int> availableMibs();
  58.     static QTextCodec* codecForLocale();
  59.     static void setCodecForLocale(QTextCodec *c);
  60.     static QTextCodec* codecForTr();
  61.     static void setCodecForTr(QTextCodec *c);
  62.     static QTextCodec* codecForCStrings();
  63.     static void setCodecForCStrings(QTextCodec *c);
  64.     static QTextCodec *codecForHtml(const QByteArray &ba);
  65.     static QTextCodec *codecForHtml(const QByteArray &ba, QTextCodec *defaultCodec);
  66.     QTextDecoder* makeDecoder() const;
  67.     QTextEncoder* makeEncoder() const;
  68.     bool canEncode(QChar) const;
  69.     bool canEncode(const QString&) const;
  70.     QString toUnicode(const QByteArray&) const;
  71.     QString toUnicode(const char* chars) const;
  72.     QByteArray fromUnicode(const QString& uc) const;
  73.     enum ConversionFlag {
  74.         DefaultConversion,
  75.         ConvertInvalidToNull = 0x80000000,
  76.         IgnoreHeader = 0x1
  77.     };
  78.     Q_DECLARE_FLAGS(ConversionFlags, ConversionFlag)
  79.     struct ConverterState {
  80.         ConverterState(ConversionFlags f = DefaultConversion)
  81.             : flags(f), remainingChars(0), invalidChars(0), d(0) { state_data[0] = state_data[1] = state_data[2] = 0; }
  82.         ~ConverterState() { if (d) qFree(d); }
  83.         ConversionFlags flags;
  84.         int remainingChars;
  85.         int invalidChars;
  86.         uint state_data[3];
  87.         void *d;
  88.     private:
  89.         Q_DISABLE_COPY(ConverterState)
  90.     };
  91.     QString toUnicode(const char *in, int length, ConverterState *state = 0) const
  92.         { return convertToUnicode(in, length, state); }
  93.     QByteArray fromUnicode(const QChar *in, int length, ConverterState *state = 0) const
  94.         { return convertFromUnicode(in, length, state); }
  95.     virtual QByteArray name() const = 0;
  96.     virtual QList<QByteArray> aliases() const;
  97.     virtual int mibEnum() const = 0;
  98. protected:
  99.     virtual QString convertToUnicode(const char *in, int length, ConverterState *state) const = 0;
  100.     virtual QByteArray convertFromUnicode(const QChar *in, int length, ConverterState *state) const = 0;
  101.     QTextCodec();
  102.     virtual ~QTextCodec();
  103. public:
  104. #ifdef QT3_SUPPORT
  105.     static QT3_SUPPORT QTextCodec* codecForContent(const char*, int) { return 0; }
  106.     static QT3_SUPPORT const char* locale();
  107.     static QT3_SUPPORT QTextCodec* codecForName(const char* hint, int) { return codecForName(QByteArray(hint)); }
  108.     QT3_SUPPORT QByteArray fromUnicode(const QString& uc, int& lenInOut) const;
  109.     QT3_SUPPORT QString toUnicode(const QByteArray&, int len) const;
  110.     QT3_SUPPORT QByteArray mimeName() const { return name(); }
  111.     static QT3_SUPPORT QTextCodec *codecForIndex(int i) { return codecForName(availableCodecs().at(i)); }
  112. #endif
  113. private:
  114.     friend class QTextCodecCleanup;
  115.     static QTextCodec *cftr;
  116. };
  117. Q_DECLARE_OPERATORS_FOR_FLAGS(QTextCodec::ConversionFlags)
  118. inline QTextCodec* QTextCodec::codecForTr() { return cftr; }
  119. inline void QTextCodec::setCodecForTr(QTextCodec *c) { cftr = c; }
  120. inline QTextCodec* QTextCodec::codecForCStrings() { return QString::codecForCStrings; }
  121. inline void QTextCodec::setCodecForCStrings(QTextCodec *c) { QString::codecForCStrings = c; }
  122. class Q_CORE_EXPORT QTextEncoder {
  123.     Q_DISABLE_COPY(QTextEncoder)
  124. public:
  125.     explicit QTextEncoder(const QTextCodec *codec) : c(codec), state() {}
  126.     ~QTextEncoder();
  127.     QByteArray fromUnicode(const QString& str);
  128.     QByteArray fromUnicode(const QChar *uc, int len);
  129. #ifdef QT3_SUPPORT
  130.     QByteArray fromUnicode(const QString& uc, int& lenInOut);
  131. #endif
  132. private:
  133.     const QTextCodec *c;
  134.     QTextCodec::ConverterState state;
  135. };
  136. class Q_CORE_EXPORT QTextDecoder {
  137.     Q_DISABLE_COPY(QTextDecoder)
  138. public:
  139.     explicit QTextDecoder(const QTextCodec *codec) : c(codec), state() {}
  140.     ~QTextDecoder();
  141.     QString toUnicode(const char* chars, int len);
  142.     QString toUnicode(const QByteArray &ba);
  143.     void toUnicode(QString *target, const char *chars, int len);
  144.     bool hasFailure() const;
  145. private:
  146.     const QTextCodec *c;
  147.     QTextCodec::ConverterState state;
  148. };
  149. #endif // QT_NO_TEXTCODEC
  150. QT_END_NAMESPACE
  151. QT_END_HEADER
  152. #endif // QTEXTCODEC_H