class KCharsetConverter

KDE charset support class. More...

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

Public Members


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