Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-33
MBCS_MB_TO_SB_ Procedure
sbytestring:sbytecount output:input
STRING .EXT:*, INT:value
returns the converted text string containing 1-byte characters. The string variable
sbytestring must be exactly sbytecount bytes long.
rbytecount output
INT .EXT:ref:1
returns the actual byte length of the converted text string contained in
sbytestring.
charset input
INT:value
is the optional identifier of the reference MBCS. When omitted or null, the default
MBCS character set identifier from the MBCS_DEFAULTCHARSET_ procedure is
used. The following multibyte character sets are supported by this procedure:
1 HP Kanji
9 HP Hangul
10 HP Chinese Big 5
11 HP Chinese PC
12 HP KSC5601
charinfo output
INT .EXT:ref:1
is an optional parameter that returns an indication of any cause of failure. Except
for file-system error 29 (required missing parameter), this procedure does not
initiate error indications but simply passes on the errors returned by the
MBCS_CHAR_ procedure. See the MBCS_CHAR_ procedure description for
returned values and interpretations. Upon return of an error from the
MBCS_CHAR_ procedure, the operation is aborted and processing is returned to
the caller.
Considerations
The input text string may contain any combination of mixed 1-byte and multibyte
characters. Eligible multibyte characters are converted to the appropriate ASCII
equivalent characters. Other characters or bytes encountered in the input string are
moved to the output string without change. Multibyte blanks are converted to
equivalent sized strings of ASCII blanks (%H20).