 |
HP OpenVMS/Hanzi RTL Chinese Processing (HSY$)
Manual
HSY$CHG_ROM_SIZE
HSY$CHG_ROM_SIZE toggles the form (full form or half form) of the input
character.
Format
HSY$CHG_ROM_SIZE chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
Toggled character.
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
Full form and half form conversions only apply to one-byte ASCII (half
form ASCII) and multi-byte ASCII (full form ASCII). There are no half
form equivalence of other multi-byte characters such as Greek letters.
If chr is not a full form or half form character,
chr will be returned and no conversion will be done.
HSY$CHG_ROM_UPPER
HSY$CHG_ROM_UPPER converts one-byte and multi-byte letters (English
letters, Greek letters and Russian letters) to upper case.
Format
HSY$CHG_ROM_UPPER chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The corresponding uppercase character.
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
If chr is not a lower case letter (English letter,
Greek letter and Russian letter), chr will be returned
and no conversion will be done.
HSY$DX_TRA_KANA_HIRA
HSY$DX_TRA_KANA_HIRA converts Katakana character strings to Hiragana
character strings. (For Japanese characters only.)
Format
HSY$DX_TRA_KANA_HIRA 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 which are not Katakana characters 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$DX_TRA_KANA_KANA
HSY$DX_TRA_KANA_KANA toggles Kana character strings to Hiragana or
Katakana character strings. (For Japanese characters only.)
Format
HSY$DX_TRA_KANA_KANA 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
All Hiragana characters found are converted to Katakana and all
Katakana characters found are converted to Hiragana.
Characters in the input string that are not Hiragana or Katakana 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_KANA_KATA
HSY$DX_TRA_KANA_KATA converts Hiragana character strings to Katakana
character strings. (For Japanese characters only.)
Format
HSY$DX_TRA_KANA_KATA 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 which are not Hiragana characters 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$DX_TRA_ROM_CASE
HSY$DX_TRA_ROM_CASE toggles the casing of one-byte and multi-byte
letters (English letters, Greek letters and Russian letters) found in
the input string.
Format
HSY$DX_TRA_ROM_CASE 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
One-byte and multi-byte English letters, multi-byte Greek letters and
multi-byte Russian letters all contain both upper case and lower case
characters. This routine converts all upper case characters to lower
case and all lower case characters to upper case.
Characters in the input string that are not upper case or lower case
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_FULL
HSY$DX_TRA_ROM_FULL converts one-byte ASCII (half form ASCII) to
multi-byte equivalence (full form ASCII).
Format
HSY$DX_TRA_ROM_FULL 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 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_HALF
HSY$DX_TRA_ROM_HALF converts multi-byte ASCII (full form ASCII) to
one-byte (half form ASCII) equivalence.
Format
HSY$DX_TRA_ROM_HALF 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 full 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_LOWER
HSY$DX_TRA_ROM_LOWER converts one-byte and multi-byte letters (English
letters, Greek letters and Russian letters) to lower case.
Format
HSY$DX_TRA_ROM_LOWER 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 upper 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.
|
|
