KDECore
#include <kencodingdetector.h>
Public Member Functions | |
KEncodingDetector () | |
KEncodingDetector (QTextCodec *codec, EncodingChoiceSource source, AutoDetectScript script=None) | |
~KEncodingDetector () | |
AutoDetectScript | autoDetectLanguage () const |
QString | decode (const char *data, int len) |
QString | decode (const QByteArray &data) |
bool | decodedInvalidCharacters () const |
QString | decodeWithBuffering (const char *data, int len) |
const char * | encoding () const |
EncodingChoiceSource | encodingChoiceSource () const |
QString | flush () |
void | resetDecoder () |
void | setAutoDetectLanguage (AutoDetectScript) |
bool | setEncoding (const char *encoding, EncodingChoiceSource type) |
bool | visuallyOrdered () const |
Static Public Member Functions | |
static bool | hasAutoDetectionForScript (AutoDetectScript) |
static QString | nameForScript (AutoDetectScript) |
static AutoDetectScript | scriptForName (const QString &lang) |
Protected Member Functions | |
bool | analyze (const char *data, int len) |
QTextDecoder * | decoder () |
bool | errorsIfUtf8 (const char *data, int length) |
bool | processNull (char *data, int length) |
Detailed Description
Provides encoding detection capabilities.
Searches for encoding declaration inside raw data – meta and xml tags. In the case it can't find it, uses heuristics for specified language.
If it finds unicode BOM marks, it changes encoding regardless of what the user has told
Intended lifetime of the object: one instance per document.
Typical use:
Do not mix decode() with decodeWithBuffering()
Guess encoding of char array
Definition at line 58 of file kencodingdetector.h.
Member Enumeration Documentation
Definition at line 72 of file kencodingdetector.h.
Enumerator | |
---|---|
DefaultEncoding | |
AutoDetectedEncoding | |
BOM | |
EncodingFromXMLHeader | |
EncodingFromMetaTag | |
EncodingFromHTTPHeader | |
UserChosenEncoding |
Definition at line 61 of file kencodingdetector.h.
Constructor & Destructor Documentation
KEncodingDetector::KEncodingDetector | ( | ) |
Default codec is latin1 (as html spec says), EncodingChoiceSource is default, AutoDetectScript=Semiautomatic.
Definition at line 650 of file kencodingdetector.cpp.
KEncodingDetector::KEncodingDetector | ( | QTextCodec * | codec, |
EncodingChoiceSource | source, | ||
AutoDetectScript | script = None |
||
) |
Allows to set Default codec, EncodingChoiceSource, AutoDetectScript.
Definition at line 654 of file kencodingdetector.cpp.
KEncodingDetector::~KEncodingDetector | ( | ) |
Definition at line 659 of file kencodingdetector.cpp.
Member Function Documentation
|
protected |
Analyze text data.
- Returns
- true if there was enough data for accurate detection
Definition at line 875 of file kencodingdetector.cpp.
KEncodingDetector::AutoDetectScript KEncodingDetector::autoDetectLanguage | ( | ) | const |
Definition at line 668 of file kencodingdetector.cpp.
QString KEncodingDetector::decode | ( | const char * | data, |
int | len | ||
) |
The main class method.
Calls protected analyze() only the first time of the whole object life
Replaces all null chars with spaces.
Definition at line 772 of file kencodingdetector.cpp.
QString KEncodingDetector::decode | ( | const QByteArray & | data | ) |
Definition at line 784 of file kencodingdetector.cpp.
bool KEncodingDetector::decodedInvalidCharacters | ( | ) | const |
This method checks whether invalid characters were found during a decoding operation.
Note that this bit is never reset once invalid characters have been found. To force a reset, either change the encoding using setEncoding() or call resetDecoder()
- Returns
- a boolean reflecting said state.
- Since
- 4.3
- See also
- resetDecoder() setEncoding()
Definition at line 856 of file kencodingdetector.cpp.
|
protected |
- Returns
- QTextDecoder for detected encoding
Definition at line 694 of file kencodingdetector.cpp.
QString KEncodingDetector::decodeWithBuffering | ( | const char * | data, |
int | len | ||
) |
Convenience method that uses buffering.
It waits for full html head to be buffered (i.e. calls analyze every time until it returns true).
Replaces all null chars with spaces.
- Returns
- Decoded data, or empty string, if there was not enough data for accurate detection
- See also
- flush()
Definition at line 796 of file kencodingdetector.cpp.
const char * KEncodingDetector::encoding | ( | ) | const |
Convenience method.
- Returns
- mime name of detected encoding
Definition at line 678 of file kencodingdetector.cpp.
KEncodingDetector::EncodingChoiceSource KEncodingDetector::encodingChoiceSource | ( | ) | const |
Definition at line 673 of file kencodingdetector.cpp.
|
protected |
Check if we are really utf8.
Taken from kate
- Returns
- true if current encoding is utf8 and the text cannot be in this encoding
Please somebody read http://de.wikipedia.org/wiki/UTF-8 and check this code...
Definition at line 585 of file kencodingdetector.cpp.
QString KEncodingDetector::flush | ( | ) |
Convenience method to be used with decodeForHtml.
Flushes buffer.
- See also
- decodeForHtml()
Definition at line 861 of file kencodingdetector.cpp.
|
static |
Definition at line 1173 of file kencodingdetector.cpp.
|
static |
Definition at line 1207 of file kencodingdetector.cpp.
|
protected |
This nice method will kill all 0 bytes (or double bytes) and remember if this was a binary or not ;)
Definition at line 556 of file kencodingdetector.cpp.
void KEncodingDetector::resetDecoder | ( | ) |
Resets the decoder.
Any stateful decoding information (such as resulting from previous calls to decodeWithBuffering()) will be lost. Will Reset the state of decodedInvalidCharacters() as a side effect.
- Since
- 4.3
Definition at line 699 of file kencodingdetector.cpp.
|
static |
Takes lang name after it were i18n()'ed.
Definition at line 1145 of file kencodingdetector.cpp.
void KEncodingDetector::setAutoDetectLanguage | ( | KEncodingDetector::AutoDetectScript | lang | ) |
Definition at line 664 of file kencodingdetector.cpp.
bool KEncodingDetector::setEncoding | ( | const char * | encoding, |
EncodingChoiceSource | type | ||
) |
- Returns
- true if specified encoding was recognized
Definition at line 712 of file kencodingdetector.cpp.
bool KEncodingDetector::visuallyOrdered | ( | ) | const |
Definition at line 684 of file kencodingdetector.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:22:13 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.