Akt_StringX2Atari

Kurzbeschreibung:	Einen (C-)String aus einem 8-Bit-Zeichensatz in den Atari-Zeichensatz wandeln
C:	char Akt_StringX2Atari( char dest_string, short nr, char *source_string );
Pascal:	Function Akt_StringX2Atari( dest_string: PChar; nr: Integer; source_string: PChar ) : PChar;
GFA:	FUNCTION kt_string.x2atari(des%,nr&,src%)

Die Funktion Akt_StringX2Atari konvertiert den (C-)String source_string aus dem angegebenen Zeichensatz in den Atari-Zeichensatz und legt ihn in dest_string ab. Die beiden Speicherbereiche dest_string und source_string können identisch ein.

Ein Zeiger auf den Ziel-String wird zurückgegeben.

Falls KEYTAB nicht installiert ist, ein Fehler auftritt oder ein nicht vorhandener Import-Zeichensatz verwendet werden soll, wird nichts gewandelt.

Hinweis: Akt_StringX2Atari(dest, nr, source) wird intern auf Akt_BlockX2Atari(dest, nr, source, strlen(source)+1) abgebildet.