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. This procedure 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.
charinfo
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 returned by 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 shift
operation is aborted and processing is returned to the caller.
Considerations
You must not use the SHIFTSTRING procedure with text that contains multibyte characters because
of the potential damage to such characters. To avoid such potential damage, the SHIFTSTRING
procedure is replaced by the MBCS_SHIFTSTRING_ procedure whenever an MBCS is installed.
The MBCS_SHIFTSTRING_ procedure appears similar to the SHIFTSTRING procedure but has
significant differences: the characteristics of parameters are different and two parameters are
added. This procedure handles upshift and downshift operations on a string of mixed single and
multibyte characters—a function beyond the capability of the current case-shifting procedures.
Related Programming Manual
For programming information about the MBCS_SHIFTSTRING_ procedure, see the Guardian
Programmer's Guide.
816 Guardian Procedure Calls (M)