class KCharsetConverter

KDE charset support class. More...

Definition#include <kcharsets.h>
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods


Detailed Description

Class to convert character sets

This class implements converting strings between charsets and encodings.

enum Flags {INPUT_AMP_SEQUENCES=1, OUTPUT_AMP_SEQUENCES=2, AMP_SEQUENCES=INPUT_AMP_SEQUENCES|OUTPUT_AMP_SEQUENCES, UNKNOWN_TO_ASCII=4, UNKNOWN_TO_QUESTION_MARKS=0 }

Conversion flags

They can be use to specify how some characters can be converted.

INPUT_AMP_SEQUENCES - convert amp-sequences on input to coresponding characters OUTPUT_AMP_SEQUENCES - convert unknown characters to amp-sequences AMP_SEQUENCES - two above together UNKNOWN_TO_ASCII - convert unknown characters to ASCII equivalents (not implemented yet) UNKNOWN_TO_QUESTION_MARKS - convert unknown characters to '?'

 KCharsetConverter (KCharset inputCharset ,int flags=UNKNOWN_TO_QUESTION_MARKS)

Constructor. Start conversion to displayable charset

Parameters:
inputCharsetsource charset
flagsconversion flags.

 KCharsetConverter (KCharset inputCharset ,KCharset outputCharset ,int flags=UNKNOWN_TO_QUESTION_MARKS)

Constructor. Start conversion between two charsets

Parameters:
inputCharsetsource charset
outputCharsetdestination charset
flagsconversion flags. KCharsetConverter

KCharsetConverter ()

Destructor.

bool  ok ()

Did constructor suceed.

Returns: TRUE if conversion can be made, FALSE if wrong arguments were given to constructor

const KCharsetConversionResult &  convert (const char *str)

String conversion routine

Convert string between charsets

Parameters:
strstring to convert

Returns: converted string with charset info

const QList<KCharsetConversionResult> &  multipleConvert (const char *str)

String conversion routine for multiple charsets

Convert string between charsets

Parameters:
strstring to convert

Returns: converted string divided into chunks of the same charsets

const char *  outputCharset ()

Charset of converted strings

Returns: charset of strings converted using convert(const char *)

const KCharsetConversionResult &  convert (unsigned code)

Unicode to displayable character conversion

Currently works only for characters in output charset

Parameters:
codeUnicode represantation of character

const KCharsetConversionResult &  convertTag (const char *tag)

Character tag to displayable character conversion

Useful for converting HTML entities, but not only Currently it works only for characters in output charset

Parameters:
tagcharacter tag or whole amp-sequence

const KCharsetConversionResult &  convertTag (const char *tag,int &l)