QtTextCodec: Difference between revisions
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
[[Category:QtInternals]] | |||
= | [toc align_right="yes" depth="1"] | ||
Written By : Girish Ramakrishnan, ForwardBias Technologies | |||
= Introduction = | |||
In Qt, a QTextCodec provides the capability to translate to/from a particular encoding. New codecs are created by subclassing QTextCodec. Merely instantiating the subclass, registers it with Qt's codec system. Custom codecs can also be made available as codec plugins. | |||
For an introduction to encoding, see "Basics of Encoding":http://developer.qt.nokia.com/wiki/BasicsOfStringEncoding and "Basics of Locales":http://developer.qt.nokia.com/wiki/BasicsOfLocales. | |||
= | = Built-in codecs = | ||
Various common codecs are implemented in Qt itself using internal QTextCodec subclasses. See "Documentation":http://doc.qt.nokia.com/4.6/qtextcodec.html for the built-in codecs. These built-in codecs are instantiated on startup and get registered with the Qt's codec system. | |||
= Local 8-bit codec = | |||
The local 8-bit codec can convert from unicode to the character set specified in the locale and vice versa. This codec is called the "System" codec. This codec can be obtained using QTextCodec::codecForLocale() or QTextCodec::codecForName("System"). | |||
On Windows, the "System" QTextCodec uses MultiByteToWideChar and WideCharToMultiByte (with CP_ACP - ANSI code page) to convert to and from unicode. | |||
On Unix, coversion is done using ''iconv''. However, Qt can be compiled without iconv support, in which case Qt inspects the LANG, LC_CTYPE, LC_ALL environment variables to determine the codec. The codec detected has to be a part of the Qt built-in codec list (Otherwise, it defaults to latin-1). | |||
Revision as of 10:18, 24 February 2015
[toc align_right="yes" depth="1"]
Written By : Girish Ramakrishnan, ForwardBias Technologies
Introduction
In Qt, a QTextCodec provides the capability to translate to/from a particular encoding. New codecs are created by subclassing QTextCodec. Merely instantiating the subclass, registers it with Qt's codec system. Custom codecs can also be made available as codec plugins.
For an introduction to encoding, see "Basics of Encoding":http://developer.qt.nokia.com/wiki/BasicsOfStringEncoding and "Basics of Locales":http://developer.qt.nokia.com/wiki/BasicsOfLocales.
Built-in codecs
Various common codecs are implemented in Qt itself using internal QTextCodec subclasses. See "Documentation":http://doc.qt.nokia.com/4.6/qtextcodec.html for the built-in codecs. These built-in codecs are instantiated on startup and get registered with the Qt's codec system.
Local 8-bit codec
The local 8-bit codec can convert from unicode to the character set specified in the locale and vice versa. This codec is called the "System" codec. This codec can be obtained using QTextCodec::codecForLocale() or QTextCodec::codecForName("System").
On Windows, the "System" QTextCodec uses MultiByteToWideChar and WideCharToMultiByte (with CP_ACP - ANSI code page) to convert to and from unicode.
On Unix, coversion is done using iconv. However, Qt can be compiled without iconv support, in which case Qt inspects the LANG, LC_CTYPE, LC_ALL environment variables to determine the codec. The codec detected has to be a part of the Qt built-in codec list (Otherwise, it defaults to latin-1).