convertEncodedTextToString()

Die Systemfunktion 'sysLib.convertEncodedTextToString()' gibt eine alternative Codierung an, wenn Sie den Wert einer Variablen vom Typ CHAR, MBCHAR oder DBCHAR zu einer Variablen vom Typ UNICODE oder STRING zuordnen.

EGL geht davon aus, dass Variablen vom Typ CHAR, MBCHAR oder DBCHAR stets die Standarddateicodierung für Java™-Programme bzw. die angegebene Standardcodierung für COBOL-Kompilierung verwenden. Verwenden Sie die Systemfunktionen 'sysLib.convertEncodedTextToString()' und 'sysLib.convertStringToEncodedText()', um die Codierung für Zeichentext (Variablen vom Typ CHAR, MBCHAR oder DBCHAR) anzugeben, wenn diese Variablen in UNICODE-Text in einer Variablen vom Typ UNICODE oder STRING konvertiert werden und umgekehrt. Auf diese Weise können in einem einzelnen Programm unterschiedliche Codierungen verwendet werden.

Syntax

  sysLib.convertEncodedTextToString(
    Quelle CHAR | MBCHAR | DBCHAR in,
    Codierung STRING in)
  returns (Ergebnis STRING)
Quelle
Der Name der Variablen vom Typ CHAR, MBCHAR oder DBCHAR, deren Inhalt konvertiert werden soll.
Codierung
Einer der folgenden Zeichenfolgewerte (STRING):
  • In COBOL-Umgebungen muss der Wert folgendes Format haben: "Cp", gefolgt von der IBM® ID des codierten Zeichensatzes für die Codepage.
  • In Java-Umgebungen kann der Wert eine beliebige gültige Codierung sein, die von der Methode 'java.lang.String.getBytes()' akzeptiert wird.
Ergebnis
Eine Variable vom Typ STRING oder UNICODE, in der der konvertierte Text gespeichert werden soll.

Beispiel

Im folgenden Beispiel wird ein Text mit ASCII-Codierung für Arabisch einer Variablen vom Typ STRING zugeordnet:

aString = convertEncodedTextToString(aChar, "Cp1256");

Feedback