 |
HP OpenVMS/Hangul RTL Korean Processing (HSY$)
Manual
HSY$DX_TRA_ROM_SIZE
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
HSY$DX_TRA_ROM_UPPER converts one-byte and multi-byte letters (English
letters, Greek letters and Russian 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
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_KANA_HIRA
HSY$TRA_KANA_HIRA converts Katakana character strings to Hiragana
character strings. (For Japanese characters only.)
Format
HSY$TRA_KANA_HIRA 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 Katakana characters, they
will be copied to the corresponding position in the output string with
no conversion done.
HSY$TRA_KANA_KANA
HSY$TRA_KANA_KANA toggles Kana character strings to Hiragana or
Katakana characters. (For Japanese characters only.)
Format
HSY$TRA_KANA_KANA 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
All Hiragana characters found are converted to Katakana and all
Katakana characters found are converted to Hiragana.
If the characters in the input string are not Hiragana or Katakana,
they will be copied to the corresponding position in the output string
with no conversion done.
HSY$TRA_KANA_KATA
HSY$TRA_KANA_KATA converts Hiragana character strings to Katakana
character strings. (For Japanese characters only.)
Format
HSY$TRA_KANA_KATA 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 Hiragana characters, they
will be copied to the corresponding position in the output string with
no conversion done.
HSY$TRA_ROM_CASE
HSY$TRA_ROM_CASE toggles the casing of one-byte and multi-byte letters
(English letters, Greek letters and Russian 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, multi-byte Greek letters and
multi-byte Russian 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
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.
|
