Guardian Procedure Calls Reference Manual

MBCS_TESTBYTE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The MBCS_TESTBYTE_ procedure returns the identification of a specified byte contained within a
text string of mixed data.
Syntax for C Programmers
#include <cextdecs(MBCS_TESTBYTE_)>
short MBCS_TESTBYTE_ ( char *buffer
,short bytecount
,short *testindex
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
result := MBCS_TESTBYTE_ ( buffer ! i
,bytecount ! i
,testindex ! i,o
,[ charset ] ! i
,[ charinfo ] ); ! o
Parameters
buffer
input
STRING .EXT:ref:*
is a pointer to a buffer containing a properly formed text string which may contain any mixture
of one-byte and multibyte characters. A properly formed text string may not begin with the
second or subsequent byte of a multibyte character or end with a fragment of a multibyte
character. The buffer is not altered by the test operation. This procedure does not alter the
contents of the text string referenced by buffer.
bytecount
input
INT:value
is the number of bytes in the buffer text string
testindex
input, output
INT .EXT:ref:1
on input, specifies the string index of the byte in buffer to be tested.
MBCS_TESTBYTE_ Procedure 823