![]() | Patrick's Programming Library Version 6.4.21 - Dokumentation |
Character-Konvertierung. Mehr ...
Öffentliche Methoden | |
CIconv () | |
Der Konstruktor der CIconv-Klasse. Mehr ... | |
CIconv (const char *fromcode, const char *tocode) | |
Der Konstruktor der CIconv-Klasse. Mehr ... | |
~CIconv () | |
Der Destruktor der CIconv-Klasse. Mehr ... | |
int | Init (const char *fromcode, const char *tocode) |
Intialisierung der CIconv-Klasse. Mehr ... | |
CString | Transcode (CString &str) |
String von einem Charset in ein anders Transcoden. Mehr ... | |
char * | Transcode (const char *str, size_t size=0) |
String von einem Charset in ein anderes Transcoden. Mehr ... | |
char * | Transcode (const char *source, size_t size_source, size_t *size_target) |
String von einem Charset in ein anderes Transcoden. Mehr ... | |
int | Transcode (const char *source, size_t size, CBinary &target) |
String von einem Charset in ein anderes Transcoden. Mehr ... | |
int | TranscodeString (CString &str) |
String von einem Charset in ein anders Transcoden. Mehr ... | |
Öffentliche, statische Methoden | |
static int | Enumerate (CArray &list) |
Auflisten aller unterstützten Charsets. Mehr ... | |
static int | Enumerate (CAssocArray &list) |
Auflisten aller unterstützten Charsets. Mehr ... | |
Private Attribute | |
void * | cd |
CString | From |
CString | To |
Die Klasse CIconv kann verwendet werden, um einen String von einem Character-Encoding in ein anderes umzuwandeln, beispielsweise von UTF-8 in ISO8859-1.
Dazu muss nach der Instanzierung der Klasse die Init-Funktion aufgerufen werden, wobei als erster Parameter das vorhandene Encoding angegeben werden muss und als zweiter das gewünschte. Anschließend können die Functionen Transcode und TranscodeString verwendet werden.
Damit die Klasse verwendet werden kann, muss die PPL6-Library mit der ICONV-Library kompiliert worden sein. Ist dies nicht der Fall, liefern alle Funktionen einen Fehler und setzen den Fehlercode 286.
ppl6::CIconv::CIconv | ( | ) |
ppl6::CIconv::CIconv | ( | const char * | fromcode, |
const char * | tocode | ||
) |
ppl6::CIconv::~CIconv | ( | ) |
|
static |
Mit dieser Funktion werden die Namen aller unterstützten Charsets in allen bekannten Variationen zur Weiterverarbeitung in das Array list
kopiert.
[out] | list | Ein CArray-Objekt, in dem die Namen der Charsets abgelegt werden sollen. Die Liste wird zu beginn geleert, eventuell noch vorhandene Einträge gehen somit verloren. |
|
static |
Mit dieser Funktion werden die Namen aller unterstützten Charsets in allen bekannten Variationen zur Weiterverarbeitung in das Assoziative Array list
kopiert. Dabei werden identische Variationen eines Charsets auf einer Ebene zusammengefasst.
[out] | list | Ein CAssocArray-Objekt, in dem die Namen der Charsets abgelegt werden sollen. Die Liste wird zu beginn geleert, eventuell noch vorhandene Einträge gehen somit verloren. |
int ppl6::CIconv::Init | ( | const char * | fromcode, |
const char * | tocode | ||
) |
fromcode | Ein Pointer auf einen String, der den Namen des Quell-Encodings enthält, beispielsweise "ISO-8859-1". |
tocode | Ein Pointer auf einen String, der den Namen des Ziel-Encodings enthält, beispielsweise "UTF-8" |
str | Eine CString-Klasse |
char * ppl6::CIconv::Transcode | ( | const char * | str, |
size_t | size = 0 |
||
) |
[in] | str | Der Quellstring mit Null-Byte am Ende |
[in] | size | Optionaler Parameter, der die Anzahl zu übersetzender Bytes im String str angibt. Per Default wird der komplette String transkodiert. |
Im Fehlerfall wird NULL zurückgegeben und einer der folgenden Fehlercodes gesetzt:
char * ppl6::CIconv::Transcode | ( | const char * | source, |
size_t | size_source, | ||
size_t * | size_target | ||
) |
[in] | source | Der Quellstring. Dieser muss im Format vorliegen, das als Quellformat in der Init-Funktion angegeben wurde |
[in] | size_source | Anzahl zu übersetzender Bytes (nicht Zeichen) im Quellstring |
[out] | size_target | In dieser Variable wird die Größe des kodierten Strings in Bytes abgelegt. |
int ppl6::CIconv::Transcode | ( | const char * | source, |
size_t | size, | ||
CBinary & | target | ||
) |
[in] | source | Der Quellstring. Dieser muss im Format vorliegen, das als Quellformat in der Init-Funktion angegeben wurde |
[in] | size | Anzahl zu übersetzender Bytes (nicht Zeichen) im Quellstring |
[out] | target | Ein CBinary-Objekt, im dem der transkodierte String abgelegt wird. |
int ppl6::CIconv::TranscodeString | ( | CString & | str | ) |
[in,out] | str | Der umzuwandelnde String |
str
enthaltene String wurde umgewandelt.Im Fehlerfall wird false (0) zurückgegeben und einer der folgenden Fehlercodes gesetzt:
|
private |
|
private |
|
private |