Akt_StringAtari2X

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

Die Funktion Akt_StringAtari2X konvertiert den (C-)String source_string aus dem Atari-Zeichensatz in den angegebenen 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 Export-Zeichensatz verwendet werden soll, wird nichts gewandelt.

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