[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS/Hangul RTL Korean Processing (HSY$) Manual


Previous Contents


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.


Previous Next Contents