Guardian Procedure Calls Reference Manual

MBCS_CHAR_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The MBCS_CHAR_ procedure indicates whether a string of bytes is part of an HP multibyte character
set (MBCS) and that testmbcschar points to the first byte of a valid character of charset
MBCS.
The MBCS_CHAR_ procedure also performs a positive range test on all bytes of the referenced
character. If all bytes pass the range test, TRUE is returned, otherwise FALSE is returned.
Syntax for C Programmers
#include <cextdecs(MBCS_CHAR_)>
short MBCS_CHAR_ ( char *testmbcschar
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
result := MBCS_CHAR_ ( testmbcschar ! i
,[ charset ] ! i
,[ charinfo ] ); ! i,o
Parameters
testmbcschar
input
STRING .EXT:ref:*
is an extended pointer to the first of a group of bytes to be tested for membership in the MBCS
identified by the charset parameter. The caller is responsible for ensuring legitimate access
to all bytes of the group. All bytes are range tested for valid membership in the specified
character set. If any byte fails the range test, the group fails and FALSE is returned. The
testmbcschar pointer is not altered by the MBCS_CHAR_ procedure.
charset
input
INT:value
identifies the MBCS to be used. If charset is omitted or null, the default MBCS identifier
returned from the MBCS_DEFAULTCHARSET_ is used.
These MBCSs are supported by the MBCS_CHAR_ procedure:
HP Kanji1
HP Hangul9
786 Guardian Procedure Calls (M)