Akt_CharUnicode2XUtf

Kurzbeschreibung:	Ein Zeichen aus Unicode in einen der erweiterten Zeichensätze wandeln
C:	char Akt_CharUnicode2XUtf( short nr, long lunicode, char result, short *used_chars );
Pascal:	Function Akt_CharUnicode2XUtf( nr: Integer; unicode: LongInt; result: PChar; Var used_chars: Integer ) : PChar;
GFA:	FUNCTION kt_char.unicode2xutf(nr&,string%,len%, VAR read_char&)

Die Funktion Akt_CharUnicode2XUtf konvertiert ein Unicode-Zeichen in den angegebenen Zeichensatz mittels KEYT.CharUnicode2XUtf. Die Zeichensatz-Nummer 'nr' muß im Bereich Akt_getExpMinNr()..Akt_getExpMaxNr() liegen.

Hinweis: Im Parameter 'used_chars' wird die Anzahl der zur Codierung belegten Zeichen des Strings zurückgegeben, falls hier nicht NULL bzw. NIL übergeben wurde.

Hinweis: Falls für den String 'result' der Wert NULL bzw. NIL übergeben wird, wird nur die Länge des Ergebnisses gerechnet.

Tip: Mit einem Aufruf von 'result' gleich NULL bzw. NIL kann ermittelt werden, wieviel Speicher benötigt wird. Nach dem Allozieren des Speichers wird dann die Funktion zur Konversion aufgerufen.

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_CharUnicode2X zurückgegeben.