Akt_CharXUtf2Unicode

Kurzbeschreibung:	Ein Zeichen aus einem der erweiterten Zeichensätze in Unicode wandeln
C:	long Akt_CharXUtf2Unicode( short nr, char string, long len, short read_chars );
Pascal:	Function Akt_CharXUtf2Unicode( nr: Integer; str: PChar; len: LongInt; Var read_chars: Integer ) : LongInt;
GFA:	FUNCTION kt_char.xutf2unicode(nr&,str%,len%, VAR read_chars&)

Die Funktion Akt_CharXUtf2Unicode decodiert aus dem angegebenen Zeichensatz mittels KEYT.CharXUtf2Unicode ein Unicode-Zeichen und gibt es zurück. Die Zeichensatz-Nummer 'nr' muß im Bereich Akt_getImpMinNr()..Akt_getImpMaxNr() liegen.

Hinweis: Im Parameter 'read_chars' wird die Anzahl der zur Decodierung benötigten Zeichen des Strings zurückgegeben, falls hier nicht NULL bzw. NIL übergeben wurde.

Falls KEYTAB nicht installiert ist, ein Fehler auftritt oder aus einem nicht vorhandenen Zeichensatz heraus konvertiert werden soll, wird das Ergebnis einer Wandelung des Zeichen per Akt_CharX2Unicode zurückgegeben.