 |
HP OpenVMS/Hangul RTL Korean 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 vice versa.
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.
|
