Guardian Procedure Calls Reference Manual
charset
input
INT:value
identifies the multibyte character set (MBCS) to be used. If charset is omitted or null, the
default MBCS from the MBCS_DEFAULTCHARSET_ procedure is used. MBCS_REPLACEBLANK_
does not examine or validate the character set identification but simply passes it on to the
MBCS_CHAR_ procedure. All MBCSs supported by the MBCS_CHAR_ procedure are inherently
supported by this procedure. This procedure replaces different multibyte character pairs
depending on the charset value.
BecomesCharactercharset
%H2020%H8140HP Kanji
%H2020%H8140HP Hangul
%H2020%HA140HP Chinese Big 5
%H2020%H8140HP Chinese PC
%H2020%HA1A1HP KSC5601
charinfo
input, output
INT .EXT:ref:1
indicates the cause of failure of the requested test. This procedure returns file-system error 29
to indicate missing required parameters; other error indications are passed back from the
MBCS_CHAR_ procedure. For returned values and interpretations, see the MBCS_CHAR_
Procedure (page 786). Upon return of an error from the MBCS_CHAR_ procedure, the operation
is aborted and processing is returned to the caller.
Considerations
Except for the HP Hangul data format, none of the supported internal MBCS data formats use
character definitions that include single-byte values of %H20 in combination with other values to
form multibyte characters. In other words, with the exception of HP Hangul, none of the characters
of the supported internal multibyte character sets contain embedded blanks. When using any of
the supported MBCSs other than HP Hangul, following the use of this procedure, any remaining
bytes having the value of %H20 can be interpreted as ordinary blanks.
When the HP Hangul character set is specified, extra care is required because byte values of
%H20 can appear as one-byte blanks, the second byte of multibyte characters, or in pairs as
two-byte blanks.
Related Programming Manual
For programming information about the MBCS_REPLACEBLANK_ procedure, see the Guardian
Programmer's Guide.
812 Guardian Procedure Calls (M)