HSY$DX_TRA_ROM_SIZE toggles the form (full form or half form) of the input string.

Format

HSY$DX_TRA_ROM_SIZE dst,src,[len]

RETURNS

VMS usage:	cond_value
type:	longword (unsigned)
access:	write only
mechanism:	by value

Arguments

dst

VMS usage:	char_string
type:	character string
access:	write only
mechanism:	by descriptor

The destination string that stores the result of the conversion.

src

VMS usage:	char_string
type:	character string
access:	read only
mechanism:	by descriptor

The source string that is to be converted.

len

VMS usage:	word_signed
type:	word integer (signed)
access:	write only
mechanism:	by reference

The length in bytes of the converted string. If this argument is not supplied, no length information of the converted string will be returned to the caller.

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 multi-byte Greek letters.

Characters in the input string that are not full form or half form characters are copied to the corresponding position in the output string with no conversion done.

condition values returned

LIB$_INVSTRDES	Invalid string descriptor. A string descriptor has an invalid value in its DSC$B_CLASS field.
LIB$_STRTRU	Procedure successfully completed. String truncated.
LIB$_FATERRLIB	Fatal internal error. An internal consistency check has failed.
LIB$_INSVIRMEM	Insufficient virtual memory.
SS$_NORMAL	Procedure successfully completed.

HSY$DX_TRA_ROM_UPPER converts one-byte and multi-byte letters (English letters and Greek letters) to upper case.

Format

HSY$DX_TRA_ROM_UPPER dst,src,[len]

RETURNS

VMS usage:	cond_value
type:	longword (unsigned)
access:	write only
mechanism:	by value

Arguments

dst

VMS usage:	char_string
type:	character string
access:	write only
mechanism:	by descriptor

The destination string that stores the result of the conversion.

src

VMS usage:	char_string
type:	character string
access:	read only
mechanism:	by descriptor

The source string that is to be converted.

len

VMS usage:	word_signed
type:	word integer (signed)
access:	write only
mechanism:	by reference

The length in bytes of the converted string. If this argument is not supplied, no length information of the converted string will be returned to the caller.

Description

Characters in the input string that are not lower case letters are copied to the corresponding position in the output string with no conversion done.

condition values returned

LIB$INVSTRDES	Invalid string descriptor. A string descriptor has an invalid value in its DSC$B_CLASS field.
LIB$_STRTRU	Procedure successfully completed. String truncated.
LIB$_FATERRLIB	Fatal internal error. An internal consistency check has failed.
LIB$_INSVIRMEM	Insufficient virtual memory.
SS$_NORMAL	Procedure successfully completed.

HSY$DX_$TRA_SYMBOL converts the sequence of a one-byte character to a string of multi-byte symbols.

Format

HSY$DX_$TRA_SYMBOL dst,src,[len]

RETURNS

VMS usage:	cond_value
type:	longword (unsigned)
access:	write only
mechanism:	by value

The return status.

Arguments

dst

VMS usage:	char_string
type:	character string
access:	write only
mechanism:	by descriptor

The destination string that stores the result of the conversion.

src

VMS usage:	char_string
type:	character string
access:	read only
mechanism:	by descriptor

The source string that is to be converted.

len

VMS usage:	word_signed
type:	word integer (signed)
access:	write only
mechanism:	by reference

The length in bytes of the converted string. If this argument is not supplied, no length information of the converted string will be returned to the caller.

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.

condition values returned

LIB$_INVSTRDES	Invalid string descriptor. A string descriptor has an invalid value in its DSC$B_CLASS field.
LIB$_STRTRU	Procedure successfully completed. String truncated.
LIB$_FATERRLIB	Fatal internal error. An internal consistency check has failed.
LIB$_INSVIRMEM	Insufficient virtual memory.
SS$_NORMAL	Procedure successfully completed.

HSY$TRA_ROM_CASE toggles the casing of one-byte and multi-byte letters (English letters and Greek letters) found in the string.

Format

HSY$TRA_ROM_CASE 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

One-byte and multi-byte English letters and multi-byte Greek letters contain both upper and lower case characters. This routine converts all upper case characters to lower case and all lower case characters to upper case.

If the characters in the input string are not one-byte or multi-byte letters, they will be copied to the corresponding position in the output string with no conversion done.

HSY$TRA_ROM_FULL converts one-byte ASCII (half form ASCII) to multi-byte equivalence (full form ASCII).

Format

HSY$TRA_ROM_FULL 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 half form characters, they will be copied to the corresponding position in the output string with no conversion done.

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