OpenVMS/Hanyu RTL Chinese Processing (HSY$) Manual


Previous Contents


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 the 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 and Greek)
(2) From full form ASCII to half form ASCII

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 1 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.

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_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 and Greek 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 and multi-byte Greek 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 and Greek 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 and Greek letter), chr will be returned and no conversion will be done.


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 and Greek 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 and Greek letter), chr will be returned and no conversion will be done.


HSY$DX_TRA_ROM_CASE

HSY$DX_TRA_ROM_CASE toggles the casing of one-byte and multi-byte letters (English letters and Greek 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 and multi-byte Greek 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 and Greek 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.


Previous Next Contents