Guardian Procedure Calls Reference Manual

MBCS_CHARSTRING_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The MBCS_CHARSTRING_ procedure tests the contents of a data string for the exclusive use of
MBCS characters of known internal character sets. This procedure depends upon the MBCS_CHAR_
procedure to test each group of bytes in the data string for validity; it inherently supports all the
character sets known to the MBCS_CHAR_ procedure. The MBCS_CHARSTRING_ procedure
recognizes blank MBCS characters. For the purposes of this procedure, a blank MBCS character
is a string of blank (%H20) bytes of the same storage length as an MBCS character of the current
MBCS.
Syntax for C Programmers
#include <cextdecs(MBCS_CHARSTRING_)>
short MBCS_CHARSTRING_ ( char *testmbcschar
,short bytecount
,short *index
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
result := MBCS_CHARSTRING_ ( testmbcsstring ! i
,bytecount ! i
,index ! o
,[ charset ] ! i
,[ charinfo ] ); ! o
Parameters
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].
MBCS_CHARSTRING_ Procedure 791