OpenVMS/Hanyu RTL Chinese Processing (HSY$) Manual


Previous Contents


HSY$TRA_ROM_UPPER

HSY$TRA_ROM_UPPER converts one-byte and multi-byte letters (English letters and Greek 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.

Previous Contents Contents