Guardian Procedure Calls Reference Manual

index
output
INT .EXT:ref:1
is the byte index of the first byte group found in the string that is not a valid MBCS character
and is not a group of blanks (%H20) the size of an MBCS character.
charset
input
INT:value
identifies the MBCS to be used. If charset is omitted or null, the default character set from
the MBCS_DEFAULTCHARSET_ procedure is used. The MBCS_CHARSTRING_ procedure does
not examine or validate the character set identification, but simply passes it on to the
MBCS_CHAR_ procedure. MBCS_CHARSTRING_ inherently supports all the MBCSs known to
the MBCS_CHAR_ procedure.
charinfo
output
INT .EXT:ref:1
indicates the cause of failure of the MBCS_CHARSTRING_ test. The MBCS_CHARSTRING_
procedure returns a 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).
Returned Value
INT
Result of the MBCS character test of the testmbcsstring text string:
The charset parameter contains an unknown MBCS identifier (see charinfo description) or contains a
known MBCS identifier but the test of testmbcsstring for valid characters failed.
0
All MBCS characters in the testmbcsstring are valid characters (or blanks) of the specified MBCS.1
Considerations
The MBCS_CHARSTRING_ procedure uses the MBCS_CHAR_ procedure to test the specified text
string for multibyte characters. All MBCSs supported by the MBCS_CHAR_ procedure are inherently
supported by the MBCS_CHARSTRING_ procedure.
792 Guardian Procedure Calls (M)