• Skip to content
  • Skip to link menu
KDE 3.5 API Reference
  • KDE API Reference
  • @topname@
  • Sitemap
  • Contact Us
 

kdecore

KCharsets Class Reference

#include <kcharsets.h>

List of all members.


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>

Definition at line 43 of file kcharsets.h.


Public Member Functions

virtual ~KCharsets ()
QTextCodec * codecForName (const QString &name) const
QTextCodec * codecForName (const QString &n, bool &ok) const
QStringList availableEncodingNames ()
QStringList descriptiveEncodingNames ()
QString languageForEncoding (const QString &encoding)
QString encodingForName (const QString &descriptiveName)

Static Public Member Functions

static QChar fromEntity (const QString &str)
static QChar fromEntity (const QString &str, int &len)
static QString toEntity (const QChar &ch)
static QString resolveEntities (const QString &text)

Protected Member Functions

 KCharsets ()

Friends

class KGlobal

Constructor & Destructor Documentation

KCharsets::KCharsets (  )  [protected]

Protected constructor.

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

Definition at line 363 of file kcharsets.cpp.

KCharsets::~KCharsets (  )  [virtual]

Destructor.

Definition at line 368 of file kcharsets.cpp.


Member Function Documentation

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

Definition at line 525 of file kcharsets.cpp.

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

Definition at line 531 of file kcharsets.cpp.

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.

Definition at line 373 of file kcharsets.cpp.

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

Definition at line 409 of file kcharsets.cpp.

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

Definition at line 425 of file kcharsets.cpp.

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

Scans the given string for entities (like &amp;) and resolves them using fromEntity.

Parameters:
text the string containing the entities
Returns:
the clean string
Since:
3.1

Definition at line 432 of file kcharsets.cpp.

QStringList KCharsets::availableEncodingNames (  ) 

Lists all available encodings as names.

Returns:
the list of all encodings

Definition at line 478 of file kcharsets.cpp.

QStringList KCharsets::descriptiveEncodingNames (  ) 

Lists the available encoding names together with a more descriptive language.

Returns:
the list of descriptive encoding names

Definition at line 512 of file kcharsets.cpp.

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

Definition at line 488 of file kcharsets.cpp.

QString KCharsets::encodingForName ( const QString &  descriptiveName  ) 

Returns the encoding for a string obtained with descriptiveEncodingNames().

Parameters:
descriptiveName the descriptive name for the encoding
Returns:
the name of the encoding

Definition at line 495 of file kcharsets.cpp.


The documentation for this class was generated from the following files:
  • kcharsets.h
  • kcharsets.cpp

kdecore

Skip menu "kdecore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

@topname@

Skip menu "@topname@"
  •     kdnssd-avahi
  • arts
  • dcop
  • dnssd
  • interfaces
  •     interface
  •     library
  •   kspeech
  •   ktexteditor
  • kabc
  • kate
  • kcmshell
  • kdecore
  • kded
  • kdefx
  • kdeprint
  • kdesu
  • kdeui
  • kdoctools
  • khtml
  • kimgio
  • kinit
  • kio
  •   bookmarks
  •   httpfilter
  •   kfile
  •   kio
  •   kioexec
  •   kpasswdserver
  •   kssl
  • kioslave
  •   http
  • kjs
  • kmdi
  •   kmdi
  • knewstuff
  • kparts
  • kresources
  • kspell2
  • kunittest
  • kutils
  • kwallet
  • libkmid
  • libkscreensaver
Generated for @topname@ by doxygen 1.5.5
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal