KEYT.CharUnicode2XUtf

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

Die Funktion CharUnicode2XUtf codiert ein Unicode-Zeichen 'unicode' und schreibt das Resultat in den String 'string'. Die Funktion greift für 'nr' im Bereich von 0..GetExpMaxNr() auf die Funktion CharUnicode2X zurück und verwendet ein Zeichen des übergebenen Strings. Für 'nr' im Bereich GetExpMinNr()..-1 wird ein Unicode-Zeichen in ggf. mehrere Zeichen des Strings codiert.

Hinweis: Falls in 'used_char' nicht NULL bzw. NIL übergeben wird, wird dort die Anzahl der verwendeten Zeichen aus dem String eingetragen, die das codierte Unicode-Zeichen nun belegt.

Hinweis: Wenn für den String 'string' NULL bzw. NIL übergeben wird, wird nur ermittelt, wie viele Zeichen das Unicode-Zeichen benötigen würde.

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

Die Funktion CharUnicode2XUtf ist vorhanden, wenn size>=120 ist.