KEYT.CharXUtf2Unicode

Beschreibung	Ein Zeichen dekodieren und in Unicode wandeln
Aufruf C	long unicode, len; short nr, read_chars; unicode = (kt->CharXUtf2Unicode)(nr, string, len, &read_chars);
Aufruf Pascal	unicode, len : LongInt; nr, read_chars : Integer; string : Pointer; unicode := kt^.CharXUtf2Unicode(nil, nil, 0, 0, 0, nr, string, len, read_chars);
Aufruf GFA	kt_func% = {kt_struc%+112} unicode% = LONG(C:kt_func%(nr&, L:string%, L:len&, L:used_chars&))

Die Funktion CharXUtf2Unicode decodiert ein Zeichen anhand des Stringes 'string' und liefert es in Unicode zurück. Die Funktion greift für 'nr' im Bereich von 0..GetImpMaxNr() auf die Funktion CharX2Unicode zurück und verwendet ein Zeichen des übergebenen Strings. Für 'nr' im Bereich GetImpMinNr()..-1 wird ein Unicode-Zeichen aus ggf. mehreren Zeichen des Strings decodiert und zurückgegeben.

Hinweis: Falls in 'read_char' nicht NULL bzw. NIL übergeben wird, wird dort die Anzahl der benötigten Zeichen aus dem String 'string' eingetragen, die das decodierte Unicode-Zeichen ergeben haben.

Hinweis: Die Funktion CharXUtf2Unicode ist bereits auf Unicode-Zeichen vorbereitet, die den Bereich von 0xFFFF übersteigen.

Die Funktion CharXUtf2Unicode ist vorhanden, wenn size>=116 ist.