Guardian Procedure Calls Reference Manual

meet this requirement. ( See MBCS_TRIMFRAGMENT_ Procedure (page 826).) Do not
assume that an arbitrarily selected extract from a text string meets this requirement.
• This procedure does not alter the contents of the text string.
• The MBCS_TESTBYTE_ procedure tests isolated bytes in a text string for MBCS characteristics.
On each call to this procedure, the buffer text string is analyzed from the beginning up to
a point just past buffer[testindex].
Repetitive analysis of a text string from the beginning is not particularly efficient. This procedure
is not the function of choice for iterative operations where each byte or character in a text
string is to be tested and processed. For operations where it is necessary to test and process
each byte in a text string, greater efficiency can be achieved by using a user-coded procedure
which progressively tests and processes as it works its way through the target text string. For
a sample user-coded procedure, see the MBCS_CHAR_ Procedure (page 786).
Related Programming Manual
For programming information about the MBCS_TESTBYTE_ procedure, see the Guardian
Programmer's Guide.
MBCS_TESTBYTE_ Procedure 825