 |
HP OpenVMS/Hanzi RTL Chinese Processing (HSY$)
Manual
HSY$TRA_ROM_HALF
HSY$TRA_ROM_HALF converts multi-byte ASCII (full form ASCII) to
one-byte (half form ASCII) equivalence.
Format
HSY$TRA_ROM_HALF ip,il,op,ol,rl
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
|
1 -
|
The input string is successfully converted.
|
|
0 -
|
A truncated input string is converted due to insufficient output space
of the output string allocated by the caller.
|
Arguments
ip
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which is
the input for conversion.
il
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the input string.
op
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which
stores the output of conversion.
ol
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the output string.
rl
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by reference
|
The length in bytes of the converted string.
Description
If the characters in the input string are not full form characters,
they will be copied to the corresponding position in the output string
with no conversion done.
HSY$TRA_ROM_LOWER
HSY$TRA_ROM_LOWER converts one-byte and multi-byte letters (English
letters, Greek letters and Russian letters) to lower case.
Format
HSY$TRA_ROM_LOWER ip,il,op,ol,rl
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
|
1 -
|
The input string is successfully converted.
|
|
0 -
|
A truncated input string is converted due to insufficient output space
of the output string allocated by the caller.
|
Arguments
ip
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which is
the input for conversion.
il
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the input string.
op
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which
stores the output of conversion.
ol
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the output string.
rl
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by reference
|
The length in bytes of the converted string.
Description
If the characters in the input string are not upper case letters, they
will be copied to the corresponding position in the output string with
no conversion done.
HSY$TRA_ROM_SIZE
HSY$TRA_ROM_SIZE toggles the form (full form or half form) of the input
string.
Format
HSY$TRA_ROM_SIZE ip,il,op,ol,rl
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
|
1 -
|
The input string is successfully converted.
|
|
0 -
|
A truncated input string is converted due to insufficient output space
of the output string allocated by the caller.
|
Arguments
ip
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which is
the input for conversion.
il
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the input string.
op
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which
stores the output of conversion.
ol
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the output string.
rl
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by reference
|
The length in bytes of the converted string.
Description
Full form and half form conversions only apply to one-byte ASCII (half
form ASCII) and multi-byte ASCII (full form ASCII). There is no half
form equivalence of other multi-byte characters such as Greek letters.
If the characters in the input string are not full form or half form
characters, they will be copied to the corresponding position in the
output string with no conversion done.
HSY$TRA_ROM_UPPER
HSY$TRA_ROM_UPPER converts one-byte and multi-byte letters (English
letters, Greek letters and Russian letters) to upper case.
Format
HSY$TRA_ROM_UPPER ip,il,op,ol,rl
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
|
1 -
|
The input string is successfully converted.
|
|
0 -
|
A truncated input string is converted due to insufficient output space
of the output string allocated by the caller.
|
Arguments
ip
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which is
the input for conversion.
il
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the input string.
op
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read onlys
|
|
mechanism:
|
by value
|
The address of the starting position of the specified string which
stores the output of conversion.
ol
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length in bytes of the output string.
rl
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by reference
|
The length in bytes of the converted string.
Description
If the characters in the input string are not lower case letters, they
will be copied to the corresponding positions in the output string with
no conversion done.
HSY$TRA_SYMBOL
HSY$TRA_SYMBOL converts the sequence of a one-byte character to a
string of multi-byte symbols.
Format
HSY$TRA_SYMBOL ip,il,op,ol,rl
RETURNS
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
|
0 -
|
The conversion completed unsuccessfully.
|
|
1 -
|
The conversion completed successfully.
|
Arguments
ip
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the specified input string that is to be converted.
il
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length of the input string that is specified by the argument
ip.
op
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the specified output string that stores the converted
string.
ol
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The length of the output string that is specified by the argument
op.
rl
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by reference
|
The actual length of the converted string.
Description
This routine provides conversion of sequences of ASCII characters to
corresponding multi-byte symbols and multi-byte characters as stated in
the following table.
If the characters in the input string are not applicable for
conversion, they will be copied to the corresponding position in the
output string with no conversion done.
|
