summaryrefslogtreecommitdiffstats
path: root/src/projects/k3bencodingconverter.h
blob: e40003c80ab4753508f8f7d20cb14a9b70e354cb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/* 
 *
 * $Id: sourceheader 511311 2006-02-19 14:51:05Z trueg $
 * Copyright (C) 2006 Sebastian Trueg <trueg@k3b.org>
 *
 * This file is part of the K3b project.
 * Copyright (C) 1998-2007 Sebastian Trueg <trueg@k3b.org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * See the file "COPYING" for the exact licensing terms.
 */

#ifndef _K3B_ENCODING_CONVERTER_H_
#define _K3B_ENCODING_CONVERTER_H_

#include <qcstring.h>
#include <qstring.h>

class QWidget;

class K3bEncodingConverter
{
 public:
  K3bEncodingConverter();
  ~K3bEncodingConverter();

  /**
   * Check if a string is encoded using the local codeset
   *
   * \return True if the string is encoded in the local encoding.
   */
  bool encodedLocally( const QCString& );

  /**
   * Tries to fix the encoding of a string to fit the local
   * encoding.
   * It presents a dialog to the user that let's them choose
   * the proper encoding based on example conversions.
   *
   * \param s The string to be fixed.
   * \param parent The parent widget to be used when showing the encoding selection dialog.
   * \param cacheEncoding If true the codeset used for successful conversion is cached and
   *                      reused for the next call to fixEncoding.
   *
   * \return True if the conversion was successful.
   */
  bool fixEncoding( const QCString& s, QCString& result, QWidget* parent = 0, bool cacheEncoding = true );

 private:
  bool convert( const QCString& s, QCString& result, const QString& from, const QString& to );

  class Private;
  Private* d;
};

#endif