 |
HP OpenVMS/Hanzi RTL Chinese Processing (HSY$)
Manual
HSY$IS_TECHNICAL
HSY$IS_TECHNICAL checks if the input character is a scientific or
mathematical multi-byte symbol character.
Format
HSY$IS_TECHNICAL chr
RETURNS
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The returned flag.
|
0 -
|
The input character is not a technical multi-byte symbol character.
|
|
1 -
|
The input character is a technical multi-byte symbol character.
|
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
None.
HSY$IS_UNIT
HSY$IS_UNIT checks if the input character is a multi-byte standard unit
symbol character.
Format
HSY$IS_UNIT chr
RETURNS
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The returned flag.
|
0 -
|
The input character is not a multi-byte standard unit symbol character.
|
|
1 -
|
The input character is a multi-byte standard unit symbol character.
|
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
None.
HSY$IS_UPPER
HSY$IS_UPPER checks if the input character is an upper case Greek,
Russian or Roman letter.
Format
HSY$IS_UPPER chr
RETURNS
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The returned flag.
|
0 -
|
The input character is not an upper case letter character.
|
|
1 -
|
The input character is an upper case letter character.
|
Note that "letter character" here means one of the following:
|
(1)
|
one-byte English letter
|
|
(2)
|
multi-byte English letter
|
|
(3)
|
multi-byte Greek letter
|
|
(4)
|
multi-byte Russian letter
|
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
None.
HSY$IS_VALID
HSY$IS_VALID checks if the input character is a valid multi-byte
character.
Format
HSY$IS_VALID chr
RETURNS
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The returned flag.
|
0 -
|
The input character is not a valid multi-byte character.
|
|
1 -
|
The input character is a valid multi-byte character.
|
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
Valid multi-byte characters are those found in the DEC supported local
language character set.
HSY$DX_DATE_TIME
HSY$DX_DATE_TIME returns the date and time in local language format
(the time can either be the system time or the user-specified date).
Format
HSY$DX_DATE_TIME dst,[flag],[time-addr]
RETURNS
|
VMS usage:
|
cond_value
|
|
type:
|
longword (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The same condition value returned by OpenVMS Run Time Library routine
LIB$SCOPY_R_DX.
Arguments
dst
|
VMS usage:
|
char_string
|
|
type:
|
character string
|
|
access:
|
write only
|
|
mechanism:
|
by descriptor
|
The specified destination string to store the resulting time string in
local language format.
flag
|
VMS usage:
|
byte_signed
|
|
type:
|
byte integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by reference
|
|
Bit 0:
|
0 - 12 hour format (default)
|
|
|
1 - 24 hour format
|
|
Bit 1:
|
0 - Full date and time (default)
|
|
|
1 - Time only
|
If this argument is not specified, 0 will be used which means 12 hour
format with full date and time display.
time-addr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The address of the quadword that contains the user-specified date and
time in 64-bit time format. If this argument is not specified, the
current system time will be used.
Description
None.
HSY$DX_TIME
HSY$DX_TIME returns the date and time of the system time in local
language format.
Format
HSY$DX_TIME dst,[flag]
RETURNS
|
VMS usage:
|
cond_value
|
|
type:
|
longword (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The same condition value returned by OpenVMS Run Time Library routine
LIB$SCOPY_R_DX.
Arguments
dst
|
VMS usage:
|
char_string
|
|
type:
|
character string
|
|
access:
|
write only
|
|
mechanism:
|
by descriptor
|
The specified destination string to store the resulting displaying
string in local language format.
flag
|
VMS usage:
|
byte_signed
|
|
type:
|
byte integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by reference
|
|
Bit 0:
|
0 - 12 hour format (default)
|
|
|
1 - 24 hour format
|
|
Bit 1:
|
0 - Full date and time (default)
|
|
|
1 - Time only
|
If this argument is not specified, 0 will be used which means 12 hour
format with full date and time display.
Description
None.
HSY$CHG_GENERAL
HSY$CHG_GENERAL converts specified characters in one of the three
following ways:
|
(1)
|
From lower case letters to upper case letters (including English, Greek
and Russian letters)
|
|
(2)
|
From full form ASCII to half form ASCII
|
|
(3)
|
From Kana to Hiragana (for Japanese characters only)
|
Format
HSY$CHG_GENERAL chr,conv-flag
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The converted character.
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The specified character to be converted.
conv-flag
|
VMS usage:
|
longword_signed
|
|
type:
|
longword integer (signed)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Conversion flag indicating what conversion is to be done. Only bit 0 to
bit 2 of this flag is used.
|
Bit 0 = 0:
|
Performs uppercasing conversion. Uppercasing can be done to both full
form and half form letters.
|
|
Bit 1 = 0:
|
Performs full form to half form conversion.
|
|
Bit 2 = 0:
|
Performs Kana to Hiragana conversion. This is only valid for Japanese
Kana characters.
|
Description
If chr is not applicable to a particular conversion,
e.g. chr is not a letter and uppercasing conversion is
specified by conv-flag, then no conversion will be
done and chr will be returned.
HSY$CHG_KANA_HIRA
HSY$CHG_KANA_HIRA converts Katakana characters to Hiragana characters.
(For Japanese characters only.)
Format
HSY$CHG_KANA_HIRA kana
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The converted Hiragana character.
Arguments
kana
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input Kana character.
Description
If kana is not a Katakana character,
kana will be returned with no conversion done.
HSY$CHG_KANA_KANA
HSY$CHG_KANA_KANA toggles Kana characters to Hiragana or Katakana
characters. (For Japanese characters only.)
Format
HSY$CHG_KANA_KANA kana
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The converted Kana character which can either be Hiragana or Katakana.
Arguments
kana
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input Kana character.
Description
If kana is a Hiragana character, it will be converted
to a Katakana character. If kana is a Katakana
character, it will be converted to a Hiragana character.
If kana is not a Hiragana or Katakana character,
kana will be returned with no conversion done.
HSY$CHG_KANA_KATA
HSY$CHG_KANA_KATA converts Hiragana characters to Katakana characters.
(For Japanese characters only.)
Format
HSY$CHG_KANA_KATA kana
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The converted Katakana character.
Arguments
kana
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input Kana character.
Description
If kana is not a Hiragana character,
kana will be returned with no conversion done.
HSY$CHG_KEISEN
HSY$CHG_KEISEN converts '0' to '9' and '-' to multi-byte line drawing
characters.
Format
HSY$CHG_KEISEN chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
Returned multi-byte line drawing character.
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
The input character code (see description).
Description
The conversion table is as follows:
If chr is not from '0' to '9' or '-',
chr will be returned with no conversion done.
HSY$CHG_ROM_CASE
HSY$CHG_ROM_CASE toggles the casing of one-byte and multi-byte letters
(English letters, Greek letters and Russian letters) of the input
character.
Format
HSY$CHG_ROM_CASE chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
Converted character with its case toggled.
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
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 upper case characters to lower case
characters and lower case characters to upper case characters.
If chr is not a one-byte or multi-byte letter as
stated above, chr will be returned and no conversion
will be done.
HSY$CHG_ROM_FULL
HSY$CHG_ROM_FULL converts one-byte ASCII (half form ASCII) to
multi-byte equivalence (full form ASCII).
Format
HSY$CHG_ROM_FULL chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The corresponding full form ASCII 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 half form ASCII character,
chr will be returned and no conversion will be done.
HSY$CHG_ROM_HALF
HSY$CHG_ROM_HALF converts multi-byte ASCII (full form ASCII) to
one-byte (half form ASCII) equivalence.
Format
HSY$CHG_ROM_HALF chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The corresponding half form ASCII 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 full form character,
chr will be returned and no conversion will be done.
HSY$CHG_ROM_LOWER
HSY$CHG_ROM_LOWER converts one-byte and multi-byte letters (English
letters, Greek letters and Russian letters) to lower case.
Format
HSY$CHG_ROM_LOWER chr
RETURNS
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
write only
|
|
mechanism:
|
by value
|
The corresponding lowercase character.
Arguments
chr
|
VMS usage:
|
longword_unsigned
|
|
type:
|
longword integer (unsigned)
|
|
access:
|
read only
|
|
mechanism:
|
by value
|
Input character.
Description
If chr is not an upper case letter (English letter,
Greek letter and Russian letter), chr will be returned
and no conversion will be done.
|
