HPlogo MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions (ABORTSESS - FCLOSE)

CTRANSLATE

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Converts a string of characters between EBCDIC and ASCII, or between EBCDIK (HP-specific version of EBCDIC) and KANA8 (8-bit, Japanese International Standard (JIS) version of USASCII code).

Syntax



              I16V       CA        CA         I16V
  CTRANSLATE (transcode, inbuffer, outbuffer, bufferlength,
              CA
              transtable);

Parameters


transcode

16-bit signed integer by value (required)

Passes one of the following translation identifiers:

ValueMeaning
0User-supplied table specified in the transtable parameter
1Convert EBCDIC to ASCII
2Convert ASCII to EBCDIC
3Reserved for operating system
4Reserved for operating system
5Convert EBCDIK to KANA8 (JIS)
6Convert KANA8 (JIS) to EBCDIK

inbuffer

character array (required)

Passes the string of characters to be translated.

outbuffer

character array (optional)

Passes the translated character string. If an outbuffer parameter is not specified, all translation occurs within inbuffer. The inbuffer and outbuffer parameters can specify the same array.

bufferlength

16-bit signed integer by value (required)

Passes the number of characters to be converted.

transtable

character array (required when transcode=0, otherwise optional)

Passes the user-defined translation table. The contents and order of transtable define the translation process. Transtable must be <= 256 bytes. Transtable is constructed so that each byte corresponds to a byte value in the source string to be translated. For example, the first byte in transtable gives the code to be substituted for source bytes whose value is 0.

Condition Codes


CCE (2)Request granted. Translation performed successfully.
CCG (0)Not returned.
CCL (1)Request denied. An error occurred.

Related Information


Intrinsics ASCII, BINARY, DASCII, DBINARY, HPFPCONVERT
Manuals Data Types Conversion Programmer's Guide




CREATEPROCESS


DASCII