Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-50
MBCS_TESTBYTE_ Procedure
buffer input
STRING .EXT:ref:*
is a pointer to a buffer containing a properly formed text string which may contain
any mixture of 1-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.
On output, if
result indicates that buffer[testindex] is part of a multibyte
character, then
testindex contains the byte index of the first byte of the multibyte
character containing the tested byte.
charset input
INT:value
identifies the multibyte character set (MBCS) to be used. If
charset is omitted or
null, the MBCS returned from the MBCS_DEFAULTCHARSET_ procedure is used.
This procedure does not examine or validate the character set identification, but
simply passes it on to the MBCS_CHAR_ procedure. All MBCSs supported by the
MBCS_CHAR_ procedure are supported by this procedure.
charinfo output
INT .EXT:ref:1
indicates the cause of failure of the requested test. This procedure returns 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. Upon return of an
error from the MBCS_CHAR_ procedure, the operation is aborted and processing
is returned to the caller.