Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-11
MBCS_CHARSTRING_ Procedure
0 indicates that 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.
1 indicates that all MBCS characters in the
testmbcsstring are valid
characters (or blanks) of the specified MBCS.
testmbcsstring input
STRING .EXT:ref:*
is an extended pointer to the first byte of a data string to be tested. The contents
of the data string are not altered by the MBCS_CHARSTRING_ procedure.
bytecount input
INT:value
is the number of bytes contained in
testmbcsstring. The
MBCS_CHARSTRING_ procedure tests only the number of bytes specified in the
bytecount parameter and does not access the area beyond
testmbcsstring[bytecount-1].
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. See the MBCS_CHAR_ procedure description for
returned values and interpretations.