HP 3000 Manuals HP 3000 Manuals
CTRANSLATE
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 |
| CTRANSLATE(transcode,inbuffer,outbuffer,|
| I16V CA |
| bufferlength,transtable); |
_______________________________________________
Parameters
transcode 16-bit signed integer by value (required)
Passes one of the following translation
identifiers:
Value Meaning
0 User-supplied table specified in the transtable
parameter
1 Convert EBCDIC to ASCII
2 Convert ASCII to EBCDIC
3 Reserved for operating system
4 Reserved for operating system
5 Convert EBCDIK to KANA8 (JIS)
6 Convert 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 None
Commands None
Manuals Data Types Conversion Programmer's Guide
(32650-90015)