Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-38
MBCS_SB_TO_MB_ Procedure
mbytestring:mbytecount output:input
STRING .EXT:*, INT:value
returns the converted text string containing multibyte characters. The string
variable
mbytestring must be exactly mbytecount bytes long.
rbytecount output
INT .EXT:ref:1
returns the actual byte length of the converted text string contained in
mbytestring.
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. is an
optional reference parameter used to return an indication of any cause of failure of
the requested test. Except for file-system error 29 (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. All 1-byte ASCII characters are converted to the appropriate ASCII
equivalent characters in the specified multibyte character set. Other characters or
bytes encountered in the input string are moved to the output string without change.
All 1-byte blanks are moved without conversion or extension.