---

KCharsets Class Reference

#include <kcharsets.h>

List of all members.

Public Methods
virtual	~KCharsets ()
QTextCodec *	codecForName (const QString &name) const
QTextCodec *	codecForName (const QString &n, bool &ok) const
QStringList	availableEncodingNames ()
QStringList	descriptiveEncodingNames ()
QStringList	languages ()
QStringList	encodingsForLanguage (const QString &language)
QString	languageForEncoding (const QString &encoding)
QString	encodingForName (const QString &descriptiveName)
Static Public Methods
QChar	fromEntity (const QString &str)
QChar	fromEntity (const QString &str, int &len)
QString	toEntity (const QChar &ch)
QString	resolveEntities (const QString &text)
Protected Methods
	KCharsets ()

---

Detailed Description

Charset font and encoder/decoder handling.

This is needed, because Qt's font matching algorithm gives the font family a higher priority than the charset. For many applications this is not acceptable, since it can totally obscure the output, in languages which use non iso-8859-1 charsets.

Author:

Lars Knoll <knoll@kde.org>

Version:

Id:

kcharsets.h,v 1.53.2.1 2003/02/09 13:55:28 rnolden Exp

Definition at line 44 of file kcharsets.h.

---

Constructor & Destructor Documentation

KCharsets::KCharsets (    )  [protected]

Protected constructor. If you need the kcharsets object, use KGlobal::charsets() instead.

virtual KCharsets::~KCharsets (    )  [virtual]

Destructor.

---

Member Function Documentation

QStringList KCharsets::availableEncodingNames (    )

Lists all available encodings as names. Returns: the list of all encodings

QTextCodec* KCharsets::codecForName (  const QString &    n, bool &    ok )  const

Tries to find a QTextCodec to convert the given encoding from and to Unicode. If no codec could be found the latin1 codec will be returned an ok will be set to false. Returns: the QTextCodec. If the desired codec could not be found, it returns a default (Latin-1) codec

QTextCodec* KCharsets::codecForName (  const QString &    name )  const

Provided for compatibility. Parameters: name  the name of the codec Returns: the QTextCodec. If the desired codec could not be found, it returns a default (Latin-1) codec

QStringList KCharsets::descriptiveEncodingNames (    )

Lists the available encoding names together with a more descriptive language. Returns: the list of descriptive encoding names

QString KCharsets::encodingForName (  const QString &    descriptiveName )

Returns the encoding for a string obtained with descriptiveEncodingNames(). Parameters: the  descriptive name for the encoding Returns: the name of the encoding

QStringList KCharsets::encodingsForLanguage (  const QString &    language )

Lists all available encodings for language name 'language'. Parameters: language  to language to search for Returns: the list of encodings for the language

QChar KCharsets::fromEntity (  const QString &    str, int &    len )  [static]

Overloaded member function. Tries to find an entity in the QString str. Parameters: str  the string containing entified len  is a return value, that gives the length of the decoded entity. Returns: a decoded entity if one could be found, QChar::null otherwise

QChar KCharsets::fromEntity (  const QString &    str )  [static]

Converts an entity to a character. The string must contain only the entity without the trailing ';'. Parameters: str  the entity Returns: QChar::null if the entity could not be decoded.

QString KCharsets::languageForEncoding (  const QString &    encoding )

Returns the language the encoding is used for. Parameters: encoding  the encoding for the language Returns: the language of the encoding

QStringList KCharsets::languages (    )

Lists all languages. Returns: a list of all languages

QString KCharsets::resolveEntities (  const QString &    text )  [static]

Scans the given string for entities (like &) and resolves them using fromEntity. Parameters: text  the string containing the entities Returns: the clean string Since: 3.1

QString KCharsets::toEntity (  const QChar &    ch )  [static]

Converts a QChar to an entity. The returned string does already contain the leading '&' and the trailing ';'. Parameters: ch  the char to convert Returns: the entity

---

The documentation for this class was generated from the following file:

• kcharsets.h

---