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");